https://github.com/monkilabs/opencastle
Multi agens orchestration setup for Github Copilot, Cursor, Claude Code, OpenCode, Windsurf, Codex and Antigravity.
https://github.com/monkilabs/opencastle
ai ai-agents ai-agents-automation ai-agents-cli ai-agents-framework ai-agents-mcp ai-coding-agent ai-coding-assistant ai-coding-tools claude-ai copilot copilot-coding-agent cursor-ai multi-agent multi-agent-system orchestration orchestration-framework orchestration-systems vibe-coding vibecoding
Last synced: about 1 month ago
JSON representation
Multi agens orchestration setup for Github Copilot, Cursor, Claude Code, OpenCode, Windsurf, Codex and Antigravity.
- Host: GitHub
- URL: https://github.com/monkilabs/opencastle
- Owner: monkilabs
- License: other
- Created: 2026-02-26T06:28:10.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-02T08:27:21.000Z (about 2 months ago)
- Last Synced: 2026-04-03T07:56:45.822Z (about 2 months ago)
- Topics: ai, ai-agents, ai-agents-automation, ai-agents-cli, ai-agents-framework, ai-agents-mcp, ai-coding-agent, ai-coding-assistant, ai-coding-tools, claude-ai, copilot, copilot-coding-agent, cursor-ai, multi-agent, multi-agent-system, orchestration, orchestration-framework, orchestration-systems, vibe-coding, vibecoding
- Language: TypeScript
- Homepage: http://www.opencastle.dev/
- Size: 13.9 MB
- Stars: 18
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-cli-coding-agents - OpenCastle - agent orchestration framework that turns AI coding assistants (Copilot, Cursor, Claude Code, OpenCode, Windsurf, Codex CLI) into 19 coordinated specialist agents. CLI-driven (`npx opencastle init`), with task decomposition, parallel work, and quality gates. MIT. (Harnesses & orchestration / Orchestrators & autonomous loops)
README
# OpenCastle
Turn your AI coding assistant into a multi-agent team.
Website ·
Docs ·
Quick Start ·
Architecture ·
Contributing
---
Works with **[GitHub Copilot](https://github.com/features/copilot)**, **[Cursor](https://www.cursor.com/)**, **[Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview)**, **[OpenCode](https://opencode.ai/)**, **[Windsurf](https://windsurf.com/)**, **[Codex CLI](https://github.com/openai/codex)**, and **[Antigravity](https://developers.google.com/)**.
One command sets up specialized agents that decompose tasks, work in parallel, and verify each other's output — interactively through IDE chat or automated via the Convoy Engine.
Use it live in your IDE. Run it overnight with the CLI.
## Quick Start
```bash
npx opencastle init
```
The CLI asks about your IDEs and stack. It installs agents, skills, and MCP servers tailored to your project.
You can select multiple IDEs and tools — the output is adapted for each one.
### What gets generated
| IDE | Output |
|-----|--------|
| **VS Code** | `.github/` — agents, skills, workflows, prompts |
| **Cursor** | `.cursorrules` + `.cursor/rules/` |
| **Claude Code** | `CLAUDE.md` + `.claude/` |
| **OpenCode** | `AGENTS.md` + `.opencode/` + `opencode.json` |
| **Windsurf** | `.windsurfrules` + `.windsurf/rules/` |
| **Codex CLI** | `AGENTS.md` + `.codex/` |
| **Antigravity** | `GEMINI.md` + `.gemini/` |
MCP servers are auto-configured for your stack in each IDE's native format.
### Project CLI
| Command | Description |
|---------|-------------|
| `opencastle init` | Set up agents in your project |
| `opencastle update` | Update framework files (keeps your customizations) |
| `opencastle eject` | Remove the dependency, keep all files |
| `opencastle destroy` | Remove ALL OpenCastle files (reverse of init) |
| `opencastle skills` | Skill refinement and failure tracking |
| `opencastle package` | Package orchestrator as a plugin for IDE marketplaces |
### Convoy CLI
| Command | Description |
|---------|-------------|
| `opencastle start` | Go from idea to convoy spec in one command (PRD → validate → convoy → validate → fix) |
| `opencastle plan` | Run a single prompt template step (generate PRD, convoy spec, or validate) |
| `opencastle validate` | Validate a convoy YAML spec file without executing it |
| `opencastle run` | Run the Convoy Engine (deterministic, crash-recoverable orchestrator) |
| `opencastle dispute` | Manage convoy dispute resolution |
### Observability CLI
| Command | Description |
|---------|-------------|
| `opencastle dashboard` | Open the observability dashboard |
| `opencastle doctor` | Validate your setup and surface issues |
| `opencastle agents` | Manage persistent agent identities |
| `opencastle baselines` | Manage visual regression baselines |
| `opencastle log` | Append a structured event to the observability log |
| `opencastle lesson` | Append a structured lesson to LESSONS-LEARNED.md |
| `opencastle artifacts` | Manage filesystem artifact storage (prune old convoy artifacts) |
| `opencastle insights` | Analyze convoy execution history and generate recommendations |
Add `--dry-run` to any command to preview what it would change without writing files.
📖 [Full CLI documentation →](https://www.opencastle.dev/docs/cli)
## What's Inside
**Specialist Agents.** Developer, UI/UX, Database, Security, Testing, Reviewer, and more.
**On-Demand Skills.** Loaded on demand to keep context windows lean. Auto-selected during init based on your stack. All 51 skills and plugins scored 100% on the [tessl Skill Evaluator](https://tessl.io/registry?q=opencastle).
**Workflow Templates.** Features, bug fixes, data pipelines, security audits — reproducible execution templates.
**Quality gates.** Fast review after every step. Panel majority vote for high-stakes changes. Lint, test, build checks.
**Cost-aware routing.** Picks the right model tier (Premium → Quality → Standard → Fast → Economy) based on task complexity.
**Self-improving.** Agents capture lessons and graduate them into permanent instructions.
**Hybrid by design.** Use OpenCastle interactively through IDE chat for hands-on development, or run automated batch jobs overnight via the Convoy Engine.
## Dashboard
```bash
npx opencastle dashboard
```
Visualizes real agent data from your project — sessions, success rates, model usage, execution logs, and panel reviews.
Reads from the same NDJSON logs your agents already write. No setup needed.
📖 [Dashboard CLI documentation →](https://www.opencastle.dev/docs/cli#dashboard)
## Doctor
```bash
npx opencastle doctor
```
Runs multiple health checks — manifest, configs, skills, observability logs, IDE settings, MCP setup, and environment variables. Useful in CI or after upgrading.
📖 [Doctor CLI documentation →](https://www.opencastle.dev/docs/cli#doctor)
## Convoy Engine
A deterministic, crash-recoverable orchestrator inspired by Steve Yegge's [Gas Town](https://github.com/steveyegge/gastown). Define tasks in YAML, run overnight, resume after crashes.
```bash
npx opencastle run convoy.yml
```
```yaml
# convoy.yml
name: "Overnight feature batch"
version: 1
adapter: claude
branch: feat/reviews
tasks:
- id: migrate-db
agent: database-engineer
prompt: "Create a reviews table migration."
files: ["db/migrations/"]
- id: build-component
agent: ui-ux-expert
prompt: "Build a ReviewCard component."
files: ["src/components/reviews/"]
- id: wire-page
agent: developer
prompt: "Add reviews to the place detail page."
depends_on: [migrate-db, build-component]
files: ["src/pages/places/"]
gates:
- npm run lint
- npm run test
```
- **Crash-safe** — SQLite WAL persistence survives crashes, power loss, OOM kills. Resume with `--resume`.
- **Isolated** — each worker runs in its own git worktree. Changes merge back in dependency order.
- **Observable** — real-time dashboard auto-starts during execution.
- **Multi-runtime** — mix Copilot, Claude Code, Cursor, OpenCode, Windsurf, Codex, and Antigravity in the same convoy.
Generate a validated convoy spec from a plain text description — no YAML by hand:
```bash
npx opencastle start --text "Add user reviews to the place detail page"
```
The start command runs 7 steps automatically: generate PRD → validate PRD → auto-fix PRD if needed → assess complexity → generate convoy spec → validate spec → auto-fix spec if needed. For lower-level control, use `opencastle plan` to run individual steps.
📖 [Full Convoy Engine documentation →](https://www.opencastle.dev/docs/cli#run)
## Architecture
See **[ARCHITECTURE.md](ARCHITECTURE.md)** for the full diagram, workflow templates, and quality gates.
## Contributing
1. Fork the repo
2. Create a branch — `feat/your-feature` or `fix/your-fix`
3. Make changes and ensure `npm run build:cli` passes
4. Open a PR
For large changes, [open an issue](https://github.com/monkilabs/opencastle/issues) first.
## Support
OpenCastle is free and open-source.
For corporate sponsorship inquiries, open a [GitHub Discussion](https://github.com/monkilabs/opencastle/discussions).
## License
[MIT](LICENSE)