{"id":47627892,"url":"https://github.com/verkyyi/tokenman","last_synced_at":"2026-04-07T11:01:02.312Z","repository":{"id":345798405,"uuid":"1187398303","full_name":"verkyyi/tokenman","owner":"verkyyi","description":"A self-evolving scaffold for autonomous web projects. 9 workflows, hourly self-evolution, self-healing pipeline, feedback learning loop. The repo is the system.","archived":false,"fork":false,"pushed_at":"2026-04-02T06:40:39.000Z","size":2699,"stargazers_count":2,"open_issues_count":9,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-02T06:49:58.581Z","etag":null,"topics":["agent-harness","ai-agent","astro","autonomous","claude","claude-code","github-actions","harness-engineering","self-evolving","self-healing"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/verkyyi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-20T17:20:02.000Z","updated_at":"2026-04-02T06:40:43.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/verkyyi/tokenman","commit_stats":null,"previous_names":["verkyyi/agentfolio","verkyyi/tokenman"],"tags_count":4,"template":true,"template_full_name":null,"purl":"pkg:github/verkyyi/tokenman","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/verkyyi%2Ftokenman","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/verkyyi%2Ftokenman/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/verkyyi%2Ftokenman/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/verkyyi%2Ftokenman/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/verkyyi","download_url":"https://codeload.github.com/verkyyi/tokenman/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/verkyyi%2Ftokenman/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31509941,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T03:10:19.677Z","status":"ssl_error","status_checked_at":"2026-04-07T03:10:13.982Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-harness","ai-agent","astro","autonomous","claude","claude-code","github-actions","harness-engineering","self-evolving","self-healing"],"created_at":"2026-04-01T22:59:07.197Z","updated_at":"2026-04-07T11:01:02.306Z","avatar_url":"https://github.com/verkyyi.png","language":"Shell","readme":"# Tokenman\n\n**A self-evolving scaffold for autonomous web projects.**\nThe repo is the system. The scaffold's first project is itself.\n\n[![Deploy](https://github.com/verkyyi/tokenman/actions/workflows/deploy.yml/badge.svg)](https://github.com/verkyyi/tokenman/actions/workflows/deploy.yml)\n[![Self-Evolve](https://github.com/verkyyi/tokenman/actions/workflows/evolve.yml/badge.svg)](https://github.com/verkyyi/tokenman/actions/workflows/evolve.yml)\n[![Pipeline Watcher](https://github.com/verkyyi/tokenman/actions/workflows/watcher.yml/badge.svg)](https://github.com/verkyyi/tokenman/actions/workflows/watcher.yml)\n\n**[Live site](https://verkyyi.github.io/tokenman/)** · **[Agent log](https://github.com/verkyyi/tokenman/blob/main/state/agent_log.md)**\n\n---\n\n## What it is\n\nTokenman is a harness of GitHub Actions workflows that make any web project\nfully autonomous. The agent researches improvements, triages issues, writes code,\nreviews PRs, and deploys — all without human intervention.\n\nNo server. No daemon. No database. GitHub IS the infrastructure.\n\n### Key features\n\n- **Self-evolution every 3 hours** — researches 10 external sources across rotating tiers, creates issues for actionable improvements\n- **Full autonomous pipeline** — evolve → triage → coder → reviewer → deploy, with explicit workflow chaining\n- **Self-healing watcher** — monitors the pipeline every 2 hours, re-triggers broken chains, creates fix issues\n- **Feedback learning loop** — human corrections are extracted into persistent rules that shape all future agent behavior\n- **Blacklist policy** — agents can modify anything (including their own workflows) unless it's a hard block (secrets, infinite loops, build failures)\n- **Smart triage** — elaborates vague issues into structured specs with acceptance criteria and affected files\n\n---\n\n## How it works\n\n```\nEvery 3h            → evolve.yml   → research + ideas  → create issues\nIssue created       → triage.yml   → classify + elaborate → label\nagent-ready label   → coder.yml    → implement          → open PR\nPR opened           → reviewer.yml → review + merge     → deploy\nEvery 2h            → watcher.yml  → health check       → self-heal\nHuman feedback      → feedback-learner.yml → extract lesson → permanent rule\nEvery 6 hours       → analyze.yml  → strategic review   → priorities\nYour instruction    → claude-task  → Claude acts         → commit\n```\n\nEach link in the chain is an explicit `gh workflow run` call — no reliance on GitHub event propagation.\n\n---\n\n## Interacting with the pipeline\n\nYou can steer the agent at any time using these actions:\n\n| Action | What happens |\n|---|---|\n| Comment on an issue | Feedback learner extracts lessons; if actionable, re-triggers coder |\n| Close a PR without merging | Rejection detected — `agent-ready` re-added to linked issue, coder re-triggered with rejection context |\n| Close an issue as \"not planned\" | Feedback learner records an AVOID rule — agent won't create similar issues |\n| Write \"Always do X\" or \"Never do Y\" in a comment | Extracted as a permanent learned rule that shapes all future agent behavior |\n| Add `agent-ready` label to an issue | Coder picks it up on next run |\n| Run `claude-task.yml` manually | Your dev channel — type any instruction |\n\nHuman corrections compound. Say it once and the system remembers permanently.\n\n---\n\n## The fourteen workflows\n\n| Workflow | Trigger | What it does |\n|---|---|---|\n| `evolve.yml` | Every 3 hours | Researches 10 repos (rotating tiers), tracks adopters, creates improvement issues |\n| `triage.yml` | Issue opened / dispatched | Classifies, elaborates with acceptance criteria, routes to coder |\n| `coder.yml` | agent-ready label / dispatched | Implements fix on feature branch, opens PR |\n| `reviewer.yml` | PR opened / dispatched | Reviews code, runs build, merges or blocks |\n| `watcher.yml` | Every 2 hours | Monitors pipeline health, re-triggers broken chains |\n| `growth.yml` | Twice daily | Discovers distribution opportunities, creates releases, measures impact |\n| `feedback-learner.yml` | Human comment/review | Extracts lasting lessons into learned rules |\n| `deploy.yml` | Source files pushed to main | Astro build → GitHub Pages |\n| `analyze.yml` | Every 6 hours | Strategic analysis of past activity |\n| `discover.yml` | Manual dispatch | Scans apps/ folders, generates project CLAUDE.md |\n| `claude-task.yml` | Manual dispatch | Your dev channel — type any instruction |\n| `test-evolve.yml` | Issue event | Test Evolve |\n| `sync-labels.yml` | Issue event | Sync Labels |\n| `security-scan.yml` | PR event | Security Scan — Workflow YAML |\n\n---\n\n## Self-evolution\n\nThe scaffold improves itself continuously:\n\n1. **Research** — checks Claude Code, gstack, trending repos, and 7 other sources every 3 hours\n2. **Detect** — pipeline watcher catches failures and broken chains every 2 hours\n3. **Act** — creates issues that flow through the full triage → code → review → deploy pipeline\n4. **Learn** — every human correction becomes a permanent rule that shapes future behavior\n5. **Heal** — watcher re-triggers stalled workflows, coder fixes pipeline bugs\n\nThe system can modify its own workflows, skills, and rules. Only hard blocks\n(secrets in code, infinite loops, build failures) stop a merge.\n\n---\n\n## Quick start\n\n1. Fork this repo\n2. Settings → Secrets → Add `CLAUDE_CODE_OAUTH_TOKEN` ([get one](https://console.anthropic.com))\n3. Settings → Pages → Source: GitHub Actions\n4. Settings → Actions → General → Allow GitHub Actions to create and approve pull requests\n5. The scaffold starts evolving itself immediately\n\n---\n\n## Adding a project\n\nCreate a folder in `apps/` with your code. Run `discover.yml`. The agent will:\n- Scan your files and infer the stack\n- Generate `apps/your-project/CLAUDE.md` with tailored rules\n- Generate `apps/your-project/FEATURE_STATUS.md`\n- Open a PR for your review\n\n---\n\n## Architecture\n\n```\nstate/                    # Committed state (read/write every run)\n├── project_state.md      # Current priorities (overwritten each run)\n├── agent_log.md          # Append-only action log\n├── research_log.md       # Append-only research findings\n└── learned_rules.md      # Human feedback → permanent rules\n\napps/                     # Projects managed by the scaffold\n├── scaffold/             # The scaffold manages itself\n└── profile/              # Additional projects\n\n.github/workflows/        # The fourteen autonomous workflows\nskills/                   # Agent skill files (markdown prompts)\nsrc/                      # Astro site source\n```\n\n---\n\n## Philosophy\n\n\u003e The model is the agent. The code is the harness. The git log is the audit trail.\n\nEvery agent mistake becomes a learned rule. The constitution grows with the project.\nThe Issues tab is the event bus. The Actions tab is the dashboard.\nHuman corrections compound — say it once, never repeat it.\n\n---\n\n## Research sources\n\nThe evolve agent monitors external repos using a posture-based rotation across four modes: **PATTERN_HUNT** (deep-dive Active sources), **PIPELINE_WATCH** (CI health), **HORIZON_SCAN** (discover new repos), and **SYNTHESIS** (cross-reference findings). See [`state/research_sources.md`](state/research_sources.md) for the full, Claude-managed source portfolio.\n\n**Active sources:** [anthropics/claude-code](https://github.com/anthropics/claude-code) · [hesreallyhim/awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code) · [SethGammon/Citadel](https://github.com/SethGammon/Citadel) · [actions/runner](https://github.com/actions/runner) · [withastro/astro](https://github.com/withastro/astro) · [verkyyi/tokenman](https://github.com/verkyyi/tokenman) (self)\n\nPlus 12 repos on the **Watch List** under evaluation for promotion or removal.\n\n---\n\n## References\n\nBuilt on patterns from:\n- [garrytan/gstack](https://github.com/garrytan/gstack) — Garry Tan's Claude Code harness\n- [godagoo/claude-code-always-on](https://godagoo.github.io/claude-code-always-on/)\n- [mitchellh.com — harness engineering](https://mitchellh.com/writing/my-ai-adoption-journey)\n- [Anthropic — Effective Harnesses](https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents)\n- [humanlayer/12-factor-agents](https://github.com/humanlayer/humanlayer)\n\n---\n\n## License\n\nMIT — fork it, adapt it, build on it.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fverkyyi%2Ftokenman","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fverkyyi%2Ftokenman","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fverkyyi%2Ftokenman/lists"}