{"id":50785709,"url":"https://github.com/bowen31337/claw-forge-plugin","last_synced_at":"2026-06-12T07:35:17.442Z","repository":{"id":361051970,"uuid":"1252894780","full_name":"bowen31337/claw-forge-plugin","owner":"bowen31337","description":"Claude Code plugin for the claw-forge autonomous coding-agent harness — spec-driven parallel agents billed against your Claude Pro/Max subscription pool, not the metered Agent SDK allowance.","archived":false,"fork":false,"pushed_at":"2026-05-29T02:45:55.000Z","size":153,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-12T07:35:05.457Z","etag":null,"topics":["agent-harness","autonomous-agents","claude","claude-code","claude-code-plugin","coding-agent","spec-driven-development"],"latest_commit_sha":null,"homepage":"https://github.com/bowen31337/claw-forge-plugin","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bowen31337.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-05-29T01:24:02.000Z","updated_at":"2026-05-29T02:45:58.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bowen31337/claw-forge-plugin","commit_stats":null,"previous_names":["bowen31337/claw-forge-plugin"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bowen31337/claw-forge-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bowen31337%2Fclaw-forge-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bowen31337%2Fclaw-forge-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bowen31337%2Fclaw-forge-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bowen31337%2Fclaw-forge-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bowen31337","download_url":"https://codeload.github.com/bowen31337/claw-forge-plugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bowen31337%2Fclaw-forge-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34234557,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-12T02:00:06.859Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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","autonomous-agents","claude","claude-code","claude-code-plugin","coding-agent","spec-driven-development"],"created_at":"2026-06-12T07:35:16.665Z","updated_at":"2026-06-12T07:35:17.437Z","avatar_url":"https://github.com/bowen31337.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# claw-forge-plugin\n\nA Claude Code plugin that brings the [claw-forge](https://github.com/\u003corg\u003e/claw-forge)\nautonomous coding agent harness inside your interactive Claude Code session — so every\nagent invocation bills against your Claude Pro/Max subscription pool instead of the\nmetered Claude Agent SDK allowance.\n\n**Status:** Pre-implementation (v0.1.0 draft). The PRD and architecture are frozen, the\n[`app_spec.txt`](./app_spec.txt) is validated (49 features across 9 categories), and the\ndirectory layout is scaffolded — every file under `commands/`, `skills/`, `agents/`,\n`hooks/`, `CI/`, and `tests/` is an empty stub waiting on its corresponding feature.\nThe plugin's own `claw-forge run` will fill them in.\n\n## Why\n\n[Anthropic's policy](https://support.claude.com/en/articles/15036540-use-the-claude-agent-sdk-with-your-claude-plan)\ngives apps that use `claude-agent-sdk` or `claude -p` a limited credit allowance\n**separate from your Pro/Max subscription pool**. claw-forge today uses the SDK for every\nagent invocation. The plugin form moves that execution inside your CC session, where it\nbills the normal way.\n\n## Install\n\nInstall in this order:\n\n1. Install the sidecar (Python package, provides state service, Kanban UI, spec tooling,\n   git helpers):\n\n   ```sh\n   pip install -U claw-forge\n   ```\n\n   Requires `claw-forge \u003e= 0.6.0`. The `SessionStart` hook prints an upgrade hint if an\n   older version is detected.\n\n2. Install the plugin inside Claude Code:\n\n   ```\n   /plugin install claw-forge\n   ```\n\nThat's it. Open any claw-forge project and the sidecar starts automatically on session\nopen.\n\n## Hello world\n\n```sh\ncd my-project          # a git repo with a description of what you want to build\n```\n\n1. **Author a spec.** Describe the project to Claude and generate the feature list:\n\n   ```\n   /claw-forge spec-create\n   ```\n\n   The host session writes `app_spec.xml` when done.\n\n2. **Seed the plan.** Parse the spec and build the dependency graph:\n\n   ```\n   /claw-forge plan\n   ```\n\n3. **Run.** Dispatch all ready features in parallel — billed against your subscription\n   pool, not the metered SDK allowance:\n\n   ```\n   /claw-forge run\n   ```\n\n   Open the Kanban UI in another tab to watch progress:\n\n   ```\n   /claw-forge ui\n   ```\n\n4. **Merge.** When the run finishes, squash-merge every completed feature branch into\n   `main`:\n\n   ```\n   /claw-forge merge\n   ```\n\nFor brownfield projects start with `/claw-forge spec-import` to snapshot the existing\ncodebase first.\n\n## How it works (in one paragraph)\n\nYou install two things: `pip install claw-forge` (the Python sidecar — state service,\nKanban UI, spec tooling, git helpers) and `/plugin install claw-forge` (this plugin —\nslash commands, skills, subagent definitions, hooks). When you open a claw-forge project,\na SessionStart hook starts the sidecar in the background. You type `/claw-forge run`; a\nskill instructs the host session to query the sidecar for ready tasks and dispatch them\nin parallel via the Task tool. Each subagent does one feature inside an isolated git\nworktree, reports back, and the host PATCHes the state DB and squash-merges. No SDK\ncalls anywhere — the host CC session is the only thing that ever talks to Claude.\n\n## Documents\n\n- **[PRD](docs/PRD.md)** — product requirements: motivation, users, goals, success\n  metrics, feature inventory, sidecar contract dependencies, constraints, open questions\n- **[ARCHITECTURE](docs/ARCHITECTURE.md)** — technical architecture: repo layout,\n  component map, dispatch loop replacement, subagent workflow, sidecar interface,\n  hooks, sandboxing changes, build/test/CI strategy, migration path, sidecar slimming\n  needed in claw-forge v0.6.0\n- **[Sidecar contract](docs/sidecar-contract.md)** — every `claw-forge` CLI subcommand\n  the plugin calls, its flags, and its `--json` response envelope; treat this as the\n  stability boundary between the plugin and the [claw-forge sidecar](https://github.com/\u003corg\u003e/claw-forge)\n\n## Building this plugin\n\nThis repo is itself a greenfield claw-forge project:\n\n1. Sidecar `claw-forge` v0.5.x is used for the bootstrap build (acknowledged one-time\n   metered cost — see PRD §9 \"Bootstrap chicken-and-egg\").\n2. `/create-spec` (a sidecar slash command in claw-forge today) turns `docs/PRD.md` into\n   `app_spec.xml` with shape annotations.\n3. `claw-forge plan` → DAG into the state DB.\n4. `claw-forge run` builds the plugin features in parallel worktrees.\n5. After v0.1.0 ships, future plugin development uses the plugin itself.\n\n## License\n\nApache-2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbowen31337%2Fclaw-forge-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbowen31337%2Fclaw-forge-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbowen31337%2Fclaw-forge-plugin/lists"}