{"data":{"slug":"zaxbyhub-opencode-swarm","name":"opencode-swarm","tagline":"Architect-centric agentic swarm plugin for OpenCode with code generation and QA review.","github_url":"https://github.com/ZaxbyHub/opencode-swarm","owner":"ZaxbyHub","repo":"opencode-swarm","owner_avatar_url":"https://avatars.githubusercontent.com/u/294618794?v=4","primary_language":"TypeScript","stars":509,"forks":56,"topics":["agent-swarm","ai-agents","ai-coding","automation","bun","cli","code-review","coding-agent","developer-tools","github","guardrails","llm","mcp","multi-agent","open-source","opencode","opencode-plugin","planning","software-engineering","typescript"],"archived":false,"github_pushed_at":"2026-10-20T04:53:25+00:00","maintenance_label":"Very active","stars_delta_30d":43,"url":"https://www.graphcanon.com/tools/zaxbyhub-opencode-swarm","markdown_url":"https://www.graphcanon.com/tools/zaxbyhub-opencode-swarm.md","api_url":"https://www.graphcanon.com/api/graphcanon/tools/zaxbyhub-opencode-swarm","graph_url":"https://www.graphcanon.com/api/graphcanon/graph?tool=zaxbyhub-opencode-swarm","description":"  Architect-centric agentic swarm plugin for OpenCode. Hub-and-spoke orchestration with SME consultation, code generation, and QA review.","homepage_url":null,"license":"MIT","open_issues":132,"watchers":5,"ai_summary":"A TypeScript-based AI-driven development tool that facilitates code automation through an agent-swarm architecture for tasks like code generation and quality assurance, featuring a hub-and-spoke orchestration model.","readme_excerpt":"## Quick Start\n\n**→ For a complete first-run walkthrough, see [Getting Started](docs/getting-started.md).**\n\nThe 15-minute guide covers:\n- Installation (`bunx opencode-swarm install`)\n- First-run auto-configuration (architect selected automatically)\n- Running your first task\n- Troubleshooting common issues\n\nThe installer automatically:\n- Adds `opencode-swarm` to the OpenCode plugin list\n- Disables the native `explore` and `general` agents to reduce routing conflicts\n\nIt does **not** create a project config. `.opencode/opencode-swarm.json` is opt-in — create it yourself only if you want project-level overrides of the global config.\n\n---\n\n---\n\n# 1. Install the plugin (5s)\nbunx opencode-swarm install\n\n---\n\n# 4. Kick off a task — the architect plans, then gates fire automatically (15s)\nBuild me a JWT auth helper with tests.\n\n---\n\n## Plan Cursor (v6.13)\n\nThe `plan_cursor` config compresses the plan that is injected into the LLM context.\n\n```json\n{\n  \"plan_cursor\": {\n    \"enabled\": true,\n    \"max_tokens\": 1500,\n    \"lookahead_tasks\": 2\n  }\n}\n```\n\n- **enabled** – When `true` (default) Swarm injects a compact plan cursor instead of the full `plan.md`.\n- **max_tokens** – Upper bound on the number of tokens emitted for the cursor (default 1500). The cursor contains the current phase summary, the full current task, and up to `lookahead_tasks` upcoming tasks. Earlier phases are reduced to one‑line summaries.\n- **lookahead_tasks** – Number of future tasks to include in full detail (default 2). Set to `0` to show only the current task.\n\nAll three controls are honored on both context‑injection paths (the default\ninjection path and the opt‑in `context_budget.scoring` ranking path) and in the\ncontext‑budget report's token accounting (issue #2580). Disabling\n(`\"enabled\": false`) suppresses the cursor block; the remaining injections are\nunchanged — on the default path that is the phase header line, and on the\nscoring path the phase and current‑task context candidates. The full plan text\nis never injected in its place. When the cursor exceeds `max_tokens` and the\ncompact rebuild kicks in, lookahead is reduced to one task and earlier phases\ncollapse to one‑line summaries. A phase marked `[BLOCKED]` is surfaced as a\none‑line `## Phase N [BLOCKED]` summary in both renders (issue #2841); its\nsummary is reserved ahead of generic budget truncation, so it is never\nsilently dropped within the configured `max_tokens` (only when even the\nsummary cannot fit the bound does the bound win, as for every section).\n\n---\n\n## License\n\nMIT\n\n---\n\n**Stop hoping your agents figure it out. Start shipping code that actually works.**","github_created_at":"2026-01-27T16:00:05+00:00","created_at":"2026-07-15T10:42:31.107355+00:00","updated_at":"2026-10-20T06:00:59.398193+00:00","categories":[{"slug":"ai-agents","name":"AI Agents","url":"https://www.graphcanon.com/categories/ai-agents","markdown_url":"https://www.graphcanon.com/categories/ai-agents.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/ai-agents"},{"slug":"developer-tools","name":"Developer Tools","url":"https://www.graphcanon.com/categories/developer-tools","markdown_url":"https://www.graphcanon.com/categories/developer-tools.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/developer-tools"}],"tags":[{"slug":"agent-swarm","name":"agent-swarm"},{"slug":"ai-agents","name":"ai-agents"},{"slug":"automation","name":"automation"},{"slug":"cli","name":"cli"},{"slug":"code-review","name":"code-review"},{"slug":"multi-agent","name":"multi-agent"},{"slug":"opencode-plugin","name":"opencode-plugin"},{"slug":"typescript","name":"typescript"}],"trust":{"provenance":{"is_fork":false,"github_id":1143461873,"owner_type":"Organization","methodology":"github_public_v1","parent_repo":null,"near_duplicate_slugs":[]},"computed_at":"2026-10-20T06:00:58.053Z","maintenance":{"label":"Very active","score":96,"methodology":"github_public_v1","releases_90d":30,"days_since_push":0,"last_release_at":"2026-10-18T19:01:52Z","stars_delta_30d":43,"open_issues_delta_30d":75},"security_summary":{"last_scan_at":"2026-07-15T10:42:33.733209+00:00","scan_profile":"mcp_manifest","status":"no_manifest","critical_count":0,"high_count":0,"medium_count":0,"low_count":0,"scanner":"mcp_manifest@v1","scan_id":"0b1ee8c0-eb38-485c-8ef4-e57acaf1e842","pending_review_count":0}},"capability_facts":{"mcp":{"method":"github-tree-and-contents@2","reason":"Repository inspection failed; server presence is unknown.","source":"repo_scan","status":"unknown","revision":"cd5db37c9a2c8abce318e58c9fe60775fdcd3da2","source_url":"https://github.com/ZaxbyHub/opencode-swarm/tree/cd5db37c9a2c8abce318e58c9fe60775fdcd3da2","observed_at":"2026-10-20T06:00:58.379Z","server_manifest":null},"scan":{"method":"github-tree-and-contents@2","source":"repo_scan","status":"error","version":2,"coverage":{"scope":"bounded-repository-manifests","tree_complete":false,"selected_files":0,"candidate_files":0},"revision":"cd5db37c9a2c8abce318e58c9fe60775fdcd3da2","source_url":"https://github.com/ZaxbyHub/opencode-swarm/tree/cd5db37c9a2c8abce318e58c9fe60775fdcd3da2","observed_at":"2026-10-20T06:00:58.379Z","observations":[{"path":"@revision","bytes":4936,"status":"present","revision":"cd5db37c9a2c8abce318e58c9fe60775fdcd3da2","source_url":"https://github.com/ZaxbyHub/opencode-swarm/commit/cd5db37c9a2c8abce318e58c9fe60775fdcd3da2","http_status":200,"observed_at":"2026-10-20T06:00:58.551Z"},{"path":"@tree","bytes":2015232,"reason":"response-byte-limit","status":"oversize","revision":"cd5db37c9a2c8abce318e58c9fe60775fdcd3da2","source_url":"https://github.com/ZaxbyHub/opencode-swarm/tree/cd5db37c9a2c8abce318e58c9fe60775fdcd3da2","http_status":200,"observed_at":"2026-10-20T06:00:58.796Z"}]},"languages":{"value":["typescript"],"method":"github-tree-and-contents@2","source":"github.language","revision":"cd5db37c9a2c8abce318e58c9fe60775fdcd3da2","source_url":"https://github.com/ZaxbyHub/opencode-swarm/tree/cd5db37c9a2c8abce318e58c9fe60775fdcd3da2","observed_at":"2026-10-20T06:00:58.379Z"},"license_spdx":{"value":"MIT","source":"github.license","observed_at":"2026-10-20T06:00:58.379Z"}},"decision_facts":{"hosting":null,"pricing":{"model":"freemium","summary":"Open-source project under MIT license is available freely; support services or advanced features might come with a cost not detailed."},"requirements":{"notes":["Requires Bun for installation and configuration.","Installation automatically configures project settings, adjusts plugins, and overrides certain native agent functions to avoid conflicts."],"min_ram_gb":null},"constraints":{"min_ram_gb":null,"pricing_model":"freemium"},"when_to_use":["When you need robust, automated orchestration of tasks like JWT auth helper generation paired with unit tests within a project.","For projects demanding fine-tuned control over the plan injected into AI context through parameters such as `max_tokens`, enabling optimized resource use."],"when_not_to_use":["If your workflow requires continuous real-time human oversight of individual agent operations, since Opencode-Swarm automates and reduces routing conflicts by disabling native agents.","For teams unwilling to adopt new configuration files like `.opencode/opencode-swarm.json` that require specific project-level overrides setup."],"source":"enrich:decision_facts","observed_at":"2026-07-17T02:04:06.434Z"},"constraint_facets":{"min_ram_gb":null,"pricing_model":"freemium"},"decision_summary":[{"label":"Pricing","value":"freemium - Open-source project under MIT license is available freely; support services or advanced features might come with a cost not detailed."},{"label":"Requirements","value":"Requires Bun for installation and configuration.; Installation automatically configures project settings, adjusts plugins, and overrides certain native agent functions to avoid conflicts."},{"label":"Adopt for","value":"Unverified catalog guidance: Opencode-Swarm is an architect-centric AI-driven development tool built with TypeScript that leverages an agent-swarm architecture to streamline code generation and quality assurance."},{"label":"License detail","value":"MIT license allows for free use, modification, and distribution of the software."}]}}