An AI-first organization. Every repo here is developed and maintained by AI coding agents (Claude Code), with humans steering direction and reviewing the work.
Meet mad — Multi Agent Develop
A self-hosted infrastructure layer for running coding agents. mad provisions an isolated workspace, clones a GitHub repository into it, and launches an external coding agent against the code — then streams every line of the agent's stdout to you as agent.output Server-Sent Events, per session.
- Isolated by design — each session gets its own workspace, its own agent process, and its own event stream.
- Runs many at once — multiple parallel sessions, no shared state between them.
- Bring your own agent — Claude Code CLI today, plus an
opencodeprovider. - Infrastructure, not an orchestrator —
madlaunches agents and reports what they do. It does not parse tool calls, execute tools, or manage a conversation loop. That belongs to the agent's own harness.
Status: early days —
0.x. The HTTP + SSE surface is stable enough to build clients against; scope is deliberately small and honest about it.
pip install mad-edge # distribution: mad-edge · console script: mad-edge
mad-edge serve # HTTP + SSE API on 0.0.0.0:8000Prefer a guided, containerized setup? mad-cli
gives you the mad command: pip install mad-cli, then mad install walks you through
provisioning a mad-edge container end to end.
Then create a session (provisions a workspace, clones a repo), send it a prompt, and stream the results:
curl -N http://localhost:8000/v1/events/stream # live agent.output eventsmad-core is AI-first: the day-to-day writing and maintenance of these repositories is done by AI coding agents (Claude Code), working from issues and conventions checked into each repo. Humans set the direction, define the guardrails, and review every change before it merges. The tooling below exists to make that model repeatable and safe.
| Repository | What it is |
|---|---|
mad-edge |
The flagship. Self-hosted infrastructure that provisions isolated workspaces and launches coding agents against a cloned repo, streaming their output over SSE. Published on PyPI as mad-edge (formerly mad-bros). |
mad-cli |
The operator CLI (pip install mad-cli, command mad). Guided onboarding (mad install), container lifecycle, instance inventory, API-key and version management for mad-edge deployments. |
engineering-playbooks |
Cross-cutting engineering playbooks packaged as Claude Code plugins, discoverable via a plugin marketplace. Includes living-docs — a deterministic docs engine (gen_docs) plus skills that keep /docs trees generated from code. |
.github |
Org-level community health files and shared reusable GitHub Actions workflows: docs-validate (a docs quality gate on PRs) and docs-sync (mirrors /docs into an internal docs repo after merge). |
Built with agents. Reviewed by humans.