{"_id":"@agentic-swe/agentic-swe","_rev":"2-12748d5d03085268c2143b8926fa7aab","name":"@agentic-swe/agentic-swe","dist-tags":{"latest":"3.3.0"},"versions":{"3.2.0":{"name":"@agentic-swe/agentic-swe","version":"3.2.0","keywords":["claude","claude-code","agent","swe","pipeline","orchestration"],"author":{"name":"Suraj Gupta"},"license":"MIT","_id":"@agentic-swe/agentic-swe@3.2.0","maintainers":[{"name":"sg300691","email":"sg300691@gmail.com"}],"homepage":"https://agentic-swe.github.io/agentic-swe-site/","bugs":{"url":"https://github.com/agentic-swe/agentic-swe/issues"},"bin":{"agentic-swe":"bin/agentic-swe.cjs"},"dist":{"shasum":"653a78433729133f2d355c93bda960f5f3775997","tarball":"https://registry.npmjs.org/@agentic-swe/agentic-swe/-/agentic-swe-3.2.0.tgz","fileCount":361,"integrity":"sha512-QhnulH5wj3ywDjPaTlG5vkJv5+2YCCzTtDaMNAef/fYwZ2U+exRXl62y6Te8ZwNsraHTgXpRzGnQMLL9ApjqZQ==","signatures":[{"sig":"MEUCIFmNfjjDpyqN+sI+D+O7uAMv7Y2QVrNAzPZ3NZYv5jpZAiEAnBtramhMRNwxfjnJy+Rcgizve5gaJtAJZEXriZU+gAE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1628510},"engines":{"node":">=18"},"gitHead":"f6c2f08783811fd8558368bf77cb5e874f6d3e96","scripts":{"ci":"npm run verify && npm run version:check && npm test","test":"node scripts/run-node-tests.js","verify":"node scripts/verify-sanity.js && node scripts/catalog-lint.cjs","prepack":"node -e \"const fs=require('fs');const p=require('path');const r=p.join('phases');if(!fs.existsSync(r))process.exit(1)\"","test:llm":"node test/llm/run-llm-tests.cjs","test:smoke":"bash test/smoke/run-smoke.sh","work-engine":"node scripts/work-engine.cjs","catalog:lint":"node scripts/catalog-lint.cjs","memory-index":"node scripts/memory-index.cjs","memory-prime":"node scripts/memory-prime.cjs","version:bump":"bash scripts/bump-version.sh bump","catalog:index":"node scripts/catalog-index.cjs","catalog:route":"node scripts/catalog-route.cjs","memory-import":"node scripts/memory-import.cjs","swe-dashboard":"node scripts/swe-dashboard-server.cjs","version:check":"bash scripts/bump-version.sh check","memory-compact":"node scripts/memory-compact.cjs","prepublishOnly":"npm run version:check && npm run verify","summarize-work":"node scripts/summarize-work.js","seed-dashboard-demo":"node scripts/seed-dashboard-demo.cjs","memory-sliding-summary":"node scripts/memory-sliding-summary.cjs"},"_npmUser":{"name":"sg300691","email":"sg300691@gmail.com"},"repository":{"url":"git+https://github.com/agentic-swe/agentic-swe.git","type":"git"},"_npmVersion":"10.8.2","description":"Autonomous SWE pipeline (Claude Code–first; Cursor, Codex, OpenCode, and compatible hosts) — install as a plugin (marketplace or --plugin-dir). Per-work state uses .worklogs/ in your project.","directories":{},"_nodeVersion":"20.19.2","dependencies":{"ajv":"^8.18.0","sql.js":"^1.11.0","minimatch":"^9.0.5"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"ws":"^8.18.0"},"_npmOperationalInternal":{"tmp":"tmp/agentic-swe_3.2.0_1778445968073_0.24187324543459443","host":"s3://npm-registry-packages-npm-production"}},"3.3.0":{"name":"@agentic-swe/agentic-swe","version":"3.3.0","description":"Autonomous SWE pipeline (Claude Code–first; Cursor, Codex, OpenCode, and compatible hosts) — install as a plugin (marketplace or --plugin-dir). Per-work state uses .worklogs/ in your project.","license":"MIT","author":{"name":"Suraj Gupta"},"homepage":"https://agentic-swe.github.io/agentic-swe-site/","repository":{"type":"git","url":"git+https://github.com/agentic-swe/agentic-swe.git"},"bugs":{"url":"https://github.com/agentic-swe/agentic-swe/issues"},"publishConfig":{"access":"public"},"keywords":["claude","claude-code","agent","swe","pipeline","orchestration"],"engines":{"node":">=18"},"bin":{"agentic-swe":"bin/agentic-swe.cjs"},"devDependencies":{"ws":"^8.18.0"},"scripts":{"prepack":"node -e \"const fs=require('fs');const p=require('path');const r=p.join('phases');if(!fs.existsSync(r))process.exit(1)\"","prepublishOnly":"npm run version:check && npm run verify","test":"node scripts/run-node-tests.js","test:smoke":"bash test/smoke/run-smoke.sh","test:llm":"node test/llm/run-llm-tests.cjs","ci":"npm run verify && npm run version:check && npm test","verify":"node scripts/verify-sanity.js && node scripts/catalog-lint.cjs && node scripts/render-catalog-counts.cjs --check","catalog:lint":"node scripts/catalog-lint.cjs","catalog:counts":"node scripts/render-catalog-counts.cjs","catalog:route":"node scripts/catalog-route.cjs","catalog:index":"node scripts/catalog-index.cjs","summarize-work":"node scripts/summarize-work.js","swe-dashboard":"node scripts/swe-dashboard-server.cjs","seed-dashboard-demo":"node scripts/seed-dashboard-demo.cjs","work-engine":"node scripts/work-engine.cjs","memory-index":"node scripts/memory-index.cjs","memory-prime":"node scripts/memory-prime.cjs","memory-compact":"node scripts/memory-compact.cjs","memory-import":"node scripts/memory-import.cjs","memory-sliding-summary":"node scripts/memory-sliding-summary.cjs","version:check":"bash scripts/bump-version.sh check","version:bump":"bash scripts/bump-version.sh bump"},"dependencies":{"ajv":"^8.18.0","minimatch":"^9.0.5","sql.js":"^1.11.0"},"_id":"@agentic-swe/agentic-swe@3.3.0","gitHead":"f1927500c3c738f1077c66042c41b6da11931e09","_nodeVersion":"20.19.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-OX8xRgY1UwKrkUeAf5zaneSS25w2ZZsmQKdM1PGlK+IVAUcK6uIC/J3cphIUJIHKNcG9JwaGrwQI4Xiu75tqdA==","shasum":"c23ae4e5a0f1e966a1ed91b3c326178d8922e716","tarball":"https://registry.npmjs.org/@agentic-swe/agentic-swe/-/agentic-swe-3.3.0.tgz","fileCount":372,"unpackedSize":1696835,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDVjFed1Srhty6+tjjDF3spBbH6frNxkXPH51+cVjamSgIgFe+KRv9IEb/0DHyhXXf40gIeWdt7JEgah3EAM3kZNqc="}]},"_npmUser":{"name":"sg300691","email":"sg300691@gmail.com"},"directories":{},"maintainers":[{"name":"sg300691","email":"sg300691@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agentic-swe_3.3.0_1779079170511_0.5535238199472452"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-10T20:46:07.884Z","modified":"2026-05-18T04:39:30.846Z","3.2.0":"2026-05-10T20:46:08.234Z","3.3.0":"2026-05-18T04:39:30.716Z"},"bugs":{"url":"https://github.com/agentic-swe/agentic-swe/issues"},"author":{"name":"Suraj Gupta"},"license":"MIT","homepage":"https://agentic-swe.github.io/agentic-swe-site/","keywords":["claude","claude-code","agent","swe","pipeline","orchestration"],"repository":{"type":"git","url":"git+https://github.com/agentic-swe/agentic-swe.git"},"description":"Autonomous SWE pipeline (Claude Code–first; Cursor, Codex, OpenCode, and compatible hosts) — install as a plugin (marketplace or --plugin-dir). Per-work state uses .worklogs/ in your project.","maintainers":[{"name":"sg300691","email":"sg300691@gmail.com"}],"readme":"

Agentic SWE

\n\n

Claude codes your PRs. You review the receipt. Then merge.

\n\n

\n \"CI\"\n \"License:\n \"Node\"\n \"Version\"\n \n \"Agents\"\n\n \"Docs\n

\n\nAn open-source autonomous SWE pipeline that runs in your editor or CI, writes every decision into your repo, and gives you a shareable audit trail of what the AI did and why.\n\n**What you get:**\n\n- **Structured PRs** — Claude works through a state machine (lean / standard / rigorous), not one mega-prompt\n- **Cost-attributed decisions** — every phase has a dollar amount and an artifact in `.worklogs//`\n- **Audit trail** — `/receipt` renders a shareable summary suitable for a PR description, Slack, or a compliance ticket\n\n## Quickstart\n\n```bash\nnpm install -g @agentic-swe/agentic-swe\nclaude --plugin-dir \"$(agentic-swe path)\"\n```\n\nThen in Claude Code:\n\n```text\n/work Add retry logic to the API client\n# ...pipeline runs, opens a PR...\n/receipt\n```\n\n→ See [Install & first run](#install--first-run) for Cursor, Codex, OpenCode, Gemini CLI, and Claude Code plugin marketplace alternatives.\n\n## What `/receipt` looks like\n\n`/receipt` reads `.worklogs//` and renders the work item as markdown. Sample from `test/fixtures/receipt/lean-happy/`:\n\n```markdown\n# /work add-retry-logic — Add retry logic to the API client\n\n| Field | Value |\n|---|---|\n| Work ID | add-retry-logic |\n| Track | lean |\n| Status | completed |\n| Duration | 47 min |\n| Cost | $1.84 |\n| PR | https://github.com/example/repo/pull/142 |\n\n## Decisions made (6)\n\n1. **feasibility → lean-track-check** ($0.08) — lean signal → feasibility.md#L1-L20\n2. **lean-track-check → lean-track-implementation** ($0.04) — verdict: simple\n3. **lean-track-implementation → validation** ($1.33) — implementation complete → implementation.md\n4. **validation → pr-creation** ($0.21) — tests green\n5. **pr-creation → approval-wait** ($0.18) — PR opened\n6. **approval-wait → completed** ($0.00) — approved by suraj\n\n## Human gates respected (1)\n\n- `approval-wait` resolved by user at 2026-05-17T14:47:00Z — approved by suraj\n\n## Loop counters\n\n- `self_review_iter`: 0\n- `doubt_cycles`: 1\n- `code_review_iter`: 0\n\n## Verifiable references\n\n- All artifacts: `test/fixtures/receipt/lean-happy/`\n- Audit log: `test/fixtures/receipt/lean-happy/audit.log` (9 entries)\n```\n\nEvery line above is computed from `.worklogs//` — no LLM summary, no hallucinated PRs. Reproduce locally:\n\n```bash\nnode scripts/render-receipt.cjs --work-dir test/fixtures/receipt/lean-happy\n```\n\n**Docs:** [agentic-swe.github.io/agentic-swe-site](https://agentic-swe.github.io/agentic-swe-site/)\n\n---\n\n## Pipeline at a glance\n\nAfter **feasibility**, **`lean-track-check`** sets **`pipeline.track`** in **`state.json`**. Tracks merge into **PR creation** → **`approval-wait`** → **completed**.\n\n```mermaid\n%%{init: {'theme': 'dark', 'fontFamily': 'ui-sans-serif, system-ui, -apple-system, Segoe UI, sans-serif'}}%%\nflowchart TD\n start([\"/work — start or resume\"])\n feasibility[\"feasibility\"]\n check{\"lean-track-check
sets pipeline.track\"}\n lean[\"Lean track
lean-track-implementation
validation · pr-creation\"]\n std[\"Standard track
design → verification → test-strategy
implementation → self-review
validation · pr-creation\"]\n rig[\"Rigorous track
design → design-review
verification → test-strategy
implementation → self-review
code-review → permissions-check
validation · pr-creation\"]\n gate{{\"approval-wait
human gate\"}}\n done([\"completed\"])\n\n start --> feasibility --> check\n check -->|lean| lean\n check -->|standard| std\n check -->|rigorous| rig\n lean --> gate\n std --> gate\n rig --> gate\n gate --> done\n\n classDef accent fill:#1f6feb,stroke:#58a6ff,color:#ffffff,stroke-width:2px\n classDef step fill:#21262d,stroke:#30363d,color:#e6edf3,stroke-width:1px\n classDef branch fill:#21262d,stroke:#388bfd,color:#c9d1d9,stroke-width:2px\n classDef decide fill:#21262d,stroke:#d29922,color:#ffdfb8,stroke-width:2px\n classDef gateNode fill:#21262d,stroke:#a371f7,color:#e6edf3,stroke-width:2px\n\n class start,done accent\n class feasibility step\n class check decide\n class lean,std,rig branch\n class gate gateNode\n```\n\nCanonical transitions: **`state-machine.json`** and the fenced graph in **`CLAUDE.md`** (checked in CI).\n\n---\n\n## Install & first run\n\nBeyond the [Quickstart](#quickstart) above, alternate paths:\n\n**Claude Code (plugin marketplace)**\n\n```text\n/plugin marketplace add agentic-swe/agentic-swe\n/plugin install agentic-swe@agentic-swe-catalog\n```\n\n**Other hosts**\n\n| Host | How |\n|------|-----|\n| **Cursor** | `curl -fsSL https://raw.githubusercontent.com/agentic-swe/agentic-swe/main/scripts/install-cursor-plugin.sh \\| bash` |\n| **Codex** | [`.codex/INSTALL.md`](.codex/INSTALL.md) |\n| **OpenCode** | [`.opencode/`](.opencode/) |\n| **Gemini CLI** | `gemini-extension.json` · **`GEMINI.md`** |\n\nAfter enabling the plugin, run **`/install`** once to merge **`CLAUDE.md`** and an optional **`.gitignore`** entry for **`.worklogs/`**. Maintainers see [`docs/PUBLISHING.md`](docs/PUBLISHING.md).\n\n→ [Full installation guide](https://agentic-swe.github.io/agentic-swe-site/docs/installation) · [Golden path (~15 min)](https://agentic-swe.github.io/agentic-swe-site/docs/golden-path)\n\n---\n\n## Commands\n\n| Command | Role |\n|---------|------|\n| `/work` | Start or resume a work item |\n| `/plan-only` | Feasibility / design without implementation |\n| `/brainstorm` | Design-first exploration (optional UI server) |\n| `/write-plan` · `/execute-plan` | Plan bar then execution |\n| `/check budget` · `/check transition` · `/check artifacts` | Enforcement before phases / transitions |\n| `/subagent` | Browse / invoke specialists |\n| `/repo-scan` · `/test-runner` · `/lint` | Evidence helpers |\n\n**Full list:** [Usage](https://agentic-swe.github.io/agentic-swe-site/docs/usage) · **`commands/`**\n\n---\n\n## Subagents\n\n\n**138+ specialists** under **`agents/subagents/`**\n. **Auto-selected** from **`feasibility.md`** signals; manual **`/subagent invoke`** anytime.\n\n\nAcross 10 categories — Language Specialists (29), Infrastructure (16), Specialized Domains (15), Quality & Security (14), Data & AI (13), Developer Experience (13), Business & Product (11), Core Development (10), Meta & Orchestration (10), Research & Analysis (7).\n\n\n**Details:** [Subagent catalog](https://agentic-swe.github.io/agentic-swe-site/docs/subagent-catalog) · [Catalog routing](https://agentic-swe.github.io/agentic-swe-site/docs/catalog-routing)\n\n---\n\n## Work state\n\n**`.worklogs//`** holds **`state.json`** (source of truth), **`progress.md`** (timeline), **`audit.log`** (append-only), and per-phase markdown (e.g. **`feasibility.md`**, **`implementation.md`**, **`validation-results.md`**, **`pr-link.txt`**).\n\n- **State over chat** — resume from files, not from thread memory alone.\n- **Evidence** — tie claims to commands, paths, or CI (`templates/evidence-standard.md`).\n- **CI parity** — **`scripts/work-engine.cjs`** enforces **`/check`**-style rules.\n\n---\n\n## Architecture\n\nA single **Hypervisor session** (this one) owns transitions, gates, and synthesis. Three **core agents** — **developer**, **git-operations**, **pr-manager** — carry bounded work. A **design panel** (architect, security, adversarial) reviews in parallel on the rigorous track. All consult the **135+ subagent** catalog, auto-selected from repo signals.\n\n→ [Architecture overview](https://agentic-swe.github.io/agentic-swe-site/docs/architecture) (full diagram)\n\n---\n\n## Extending · CI · License\n\n| Topic | Where |\n|-------|--------|\n| Extend pipeline | **`/author-pipeline`** · [`references/authoring-pipeline-capabilities.md`](references/authoring-pipeline-capabilities.md) |\n| CI | [`.github/workflows/ci.yml`](.github/workflows/ci.yml) — **`npm run ci`** locally |\n| Research basis | [`CLAUDE.md` — Research basis](CLAUDE.md#research-basis) |\n| License | [MIT](LICENSE) · [Licensing](https://agentic-swe.github.io/agentic-swe-site/docs/licensing) |\n","readmeFilename":"README.md"}