{"id":50312394,"url":"https://github.com/e0ipso/strikethroo","last_synced_at":"2026-06-01T22:00:29.212Z","repository":{"id":313579158,"uuid":"1048925367","full_name":"e0ipso/strikethroo","owner":"e0ipso","description":"Task management for AI coding assistants","archived":false,"fork":false,"pushed_at":"2026-05-28T21:18:49.000Z","size":20810,"stargazers_count":29,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-28T22:02:07.587Z","etag":null,"topics":["agents","ai","claude-code","code-generation","codex","coding-assistant","gemini-cli","opencode"],"latest_commit_sha":null,"homepage":"https://mateuaguilo.com/strikethroo","language":"JavaScript","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/e0ipso.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-09-02T08:25:45.000Z","updated_at":"2026-05-28T21:18:53.000Z","dependencies_parsed_at":"2025-09-07T03:35:14.657Z","dependency_job_id":"02012dd1-5989-44ea-99bd-c44ce4ec99e1","html_url":"https://github.com/e0ipso/strikethroo","commit_stats":null,"previous_names":["e0ipso/ai-task-manager","e0ipso/strikethroo"],"tags_count":88,"template":false,"template_full_name":null,"purl":"pkg:github/e0ipso/strikethroo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/e0ipso%2Fstrikethroo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/e0ipso%2Fstrikethroo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/e0ipso%2Fstrikethroo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/e0ipso%2Fstrikethroo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/e0ipso","download_url":"https://codeload.github.com/e0ipso/strikethroo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/e0ipso%2Fstrikethroo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33795114,"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-01T02:00:06.963Z","response_time":115,"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":["agents","ai","claude-code","code-generation","codex","coding-assistant","gemini-cli","opencode"],"created_at":"2026-05-28T22:00:47.665Z","updated_at":"2026-06-01T22:00:29.206Z","avatar_url":"https://github.com/e0ipso.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🤖 Strikethroo\n\n[![npm version](https://img.shields.io/npm/v/strikethroo.svg)](https://www.npmjs.com/package/strikethroo)\n[![License](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)\n\n**Strikethroo: extensible AI-powered plan and task management with customizable workflows and structured development processes.**\n\nTransform complex AI prompts into organized, executable workflows through customizable hooks, templates, and progressive refinement. Works seamlessly within your existing AI subscriptions for Claude Code, Gemini CLI, and Open Code.\n\n## 🚀 Quick Start\n\nThis project ships in two parts: the **skills** (installed by [vercel-labs/skills](https://github.com/vercel-labs/skills)) and the **workspace** (initialized by this CLI). Run both:\n\n```bash\n# 1. Install the Strikethroo skills for your assistant\nnpx skills add e0ipso/strikethroo\n\n# 2. Initialize the .ai/strikethroo/ workspace\nnpx strikethroo init --harnesses claude --destination-directory .\n```\n\nThe skills give your assistant the planning, decomposition, and execution workflow; the CLI bootstraps `.ai/strikethroo/` with hooks, templates, and the hash-tracked diff-on-conflict UX. Each step is independently re-runnable. See the [migration guide](https://mateuaguilo.com/strikethroo/migration.html) for upgrade flows from 1.x.\n\nThe CLI's `init` emits the shared workspace plus harness-specific agents (e.g., `.claude/agents/` for Claude). Other harnesses rely entirely on the installed skills.\n\n## 🌐 Serve the Workspace\n\nRun a local web app over an initialized `.ai/strikethroo/` workspace:\n\n```bash\nnpx strikethroo serve\n```\n\n`serve` boots a dependency-light Node server that hosts the prebuilt single-page app as static files, exposes a read-only JSON API over the workspace model, and streams a coalesced `changed` event over Server-Sent Events whenever the workspace mutates on disk. Run it from inside an initialized workspace; if none is found it prints guidance to run `init` and exits without binding.\n\nThe viewer is read-only **except for one permitted mutation: the archive action.** A plan whose tasks are all complete (derived state `done`) shows an **Archive** control; confirming it issues `POST /api/plans/:id/archive`, which moves that plan's directory from `plans/` to `archive/`. It is strictly a directory move — no files are deleted or edited, and only `done` plans are accepted. This is the manual escape hatch for plans that are done but not yet archived; it does **not** replace the automatic archival the `st-execute-blueprint` skill performs on successful completion.\n\nFlags:\n\n- `--port \u003cn\u003e` — port to bind (default `4317`).\n- `--no-open` — do not open the browser on start.\n- `--workspace \u003cpath\u003e` — override workspace root discovery.\n\n## ✨ Key Benefits\n\n- **🔧 Fully Customizable**: Tailor hooks, templates, and workflows to your project's specific needs\n- **🎯 Extensible Architecture**: Add custom validation gates, quality checks, and workflow patterns\n- **📋 Structured Workflows**: Three-phase progressive refinement with validation gates\n- **🔄 Plan Mode Integration**: Enhance existing AI assistant features with structured task management\n- **💰 Works Within Subscriptions**: No additional API keys or costs required\n\n## 📖 Documentation\n\n### 🌐 **[Complete Documentation →](https://mateuaguilo.com/strikethroo/)**\n\nComprehensive guides covering:\n- Installation and configuration\n- Customization with hooks and templates\n- Workflow patterns and best practices\n- Architecture and design principles\n\n## 🔄 Workflow Preview\n\nOnce the skills are installed, invoke the workflow by intent — the assistant auto-loads the matching skill. There are no slash commands to memorize.\n\n**Automated end-to-end run:**\n\n\u003e \"Run the full workflow to create a user authentication system.\"\n\nThe `st-full-workflow` skill handles plan creation, task generation, and blueprint execution in a single pass.\n\n**Step-by-step (for manual review between phases):**\n\n1. **📝 Create a plan** → \"Create a plan for a user authentication system\" (`st-create-plan` skill)\n2. **🔍 Refine the plan** → \"Refine plan 1\" (`st-refine-plan` skill — useful when a second assistant should red-team the plan)\n3. **📋 Generate tasks** → \"Generate tasks for plan 1\" (`st-generate-tasks` skill)\n4. **🚀 Execute blueprint** → \"Execute the blueprint for plan 1\" (`st-execute-blueprint` skill)\n\nProgress is driven by the Agent Skills workflow: the `st-execute-blueprint` skill runs the phases, archives the plan automatically on completion, and you can inspect plan and task files directly under `.ai/strikethroo/plans/` (completed plans move to `.ai/strikethroo/archive/`).\n\n## 🤖 Supported Harnesses\n\n| Harness | Interface | Setup Time |\n|-----------|-----------|------------|\n| 🎭 **Claude** | [claude.ai/code](https://claude.ai/code) | \u003c 30 seconds |\n| 🖱️ **Cursor** | Cursor IDE | \u003c 30 seconds |\n| 💎 **Gemini** | Gemini CLI | \u003c 30 seconds |\n| 📝 **Open Code** | Open source | \u003c 30 seconds |\n| 🔮 **Codex** | Codex CLI | \u003c 30 seconds |\n| 🐙 **GitHub Copilot** | VS Code / JetBrains IDEs | \u003c 30 seconds |\n\n## 📄 License\n\nMIT License - Open source and free to use.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fe0ipso%2Fstrikethroo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fe0ipso%2Fstrikethroo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fe0ipso%2Fstrikethroo/lists"}