{"id":41260838,"url":"https://github.com/barkain/madrox","last_synced_at":"2026-05-09T12:10:16.133Z","repository":{"id":330548746,"uuid":"1065166231","full_name":"barkain/madrox","owner":"barkain","description":"Madrox — Multi-Agent Orchestrator for Claude \u0026 Codex. MCP server that spawns, delegates, and coordinates parallel AI agent teams via tmux.","archived":false,"fork":false,"pushed_at":"2026-03-29T13:02:08.000Z","size":13346,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-29T13:50:45.490Z","etag":null,"topics":["ai-agents","claude","claude-code","mcp","multi-agent","orchestration","tmux"],"latest_commit_sha":null,"homepage":null,"language":"Python","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/barkain.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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":"2025-09-27T07:17:00.000Z","updated_at":"2026-03-29T13:02:11.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/barkain/madrox","commit_stats":null,"previous_names":["barkain/madrox"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/barkain/madrox","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barkain%2Fmadrox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barkain%2Fmadrox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barkain%2Fmadrox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barkain%2Fmadrox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/barkain","download_url":"https://codeload.github.com/barkain/madrox/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barkain%2Fmadrox/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31312744,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["ai-agents","claude","claude-code","mcp","multi-agent","orchestration","tmux"],"created_at":"2026-01-23T01:58:58.305Z","updated_at":"2026-04-02T17:58:55.496Z","avatar_url":"https://github.com/barkain.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Madrox - Multi-Agent Orchestrator for Claude \u0026 Codex\n\n[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Tests](https://github.com/barkain/madrox/actions/workflows/test.yml/badge.svg)](https://github.com/barkain/madrox/actions/workflows/test.yml)\n[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"resources/assets/madrox-hero.png\" alt=\"Madrox - One becomes many. Many become unstoppable.\" width=\"800\"/\u003e\n\u003c/p\u003e\n\nAn MCP server that lets AI instances spawn and manage hierarchical networks of Claude and Codex agents. Build recursive multi-level teams with bidirectional communication, role specialization, task interruption, and real-time monitoring — all orchestrated through tmux sessions.\n\n## Why Madrox?\n\n| Capability | Claude Subagent | Madrox |\n|------------|----------------|--------|\n| Hierarchy depth | 2 levels (flat) | 3+ levels (recursive) |\n| Models | Claude only | Claude + Codex |\n| Interruption | Must terminate \u0026 restart | Stop \u0026 redirect, keep context |\n| Visibility | Black box | Full tree view, metrics, dashboard |\n| Parallel ops | Sequential only | Batch spawn/message/interrupt |\n| Communication | One-way (parent → child) | Bidirectional + peer-to-peer |\n| Workspace | Shared | Isolated per-instance |\n| Resource tracking | None | Tokens, cost limits, auto-cleanup |\n\n## Plugin Installation (Recommended)\n\nThe fastest way to get started — install Madrox as a Claude Code plugin:\n\n```bash\n# Install from local clone\n/plugin install /path/to/madrox\n```\n\nAfter installing, restart your Claude Code session. All Madrox MCP tools become available automatically. The plugin starts the HTTP backend (port 8001) and the monitor dashboard (port 3002) in the background.\n\nUse the `/madrox:dashboard` skill to open the real-time monitor dashboard in your browser.\n\n**Prerequisites:** Python 3.11+, [tmux](https://github.com/tmux/tmux/wiki/Installing), [uv](https://docs.astral.sh/uv/), npm\n\n## Quick Start (Manual)\n\n```bash\n# 1. Install\ngit clone https://github.com/barkain/madrox.git \u0026\u0026 cd madrox\nuv sync \u0026\u0026 source .venv/bin/activate\n\n# 2. Start (backend + dashboard)\n./start.sh\n\n# 3. Register with Claude Code\nclaude mcp add madrox http://localhost:8001/mcp --transport http\n```\n\nThen ask Claude Code to `spawn a madrox dev team from template` — or see [`examples/`](examples/) for scripted usage.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"resources/assets/spawn_from_template.png\" alt=\"spawn from template\" style=\"max-width:800px;width:100%;height:auto;\"/\u003e\n\u003c/p\u003e\n\n## Documentation\n\n| Topic | Link |\n|-------|------|\n| Installation \u0026 setup | [docs/SETUP.md](docs/SETUP.md) |\n| Architecture \u0026 design | [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) |\n| API reference (24+ MCP tools) | [docs/API_REFERENCE.md](docs/API_REFERENCE.md) |\n| Features \u0026 usage patterns | [docs/FEATURES.md](docs/FEATURES.md) |\n| Troubleshooting | [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) |\n| Team templates | [docs/TEMPLATES.md](docs/TEMPLATES.md) |\n| Examples | [examples/](examples/) |\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md). Run `uv run pytest tests/ -v` and `uv run ruff check src/` before submitting.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbarkain%2Fmadrox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbarkain%2Fmadrox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbarkain%2Fmadrox/lists"}