Multi-agent coding harness for local, BYOK, and ACP workflows
Connect models, run tools, inspect changes, and keep coding sessions readable.
Build with agents. Validate with evidence. Ship with confidence.
📚 Documentation • 🐛 Report Bug • 💬 Discussions
SuperQode is a coding agent harness for interactive development, local model workflows, BYOK providers, ACP coding agents, and tool-based repository work. It provides a TUI and CLI so developers can connect to the model or agent they prefer, run file/search/edit/shell tools, and get concise summaries of what changed.
SuperQE is the quality engineering workflow included with SuperQode. Use it when you want agents to stress, validate, and report on code before release. QE is an important workflow, but SuperQode is first a general coding harness.
Note (Enterprise): Enterprise adds deeper automation, evaluation testing, and enterprise integrations.
Watch the demo: SuperQode Demo
Primary (Recommended)
# Using uv (best performance)
uv tool install superqode
# Or using pip
pip install superqodeAlternate (No Python Required, SuperQode TUI Only)
Note: SuperQE (CLI) requires the Python install above (uv or pip).
# Using Homebrew (macOS/Linux)
brew install SuperagenticAI/superqode/superqode
# Using Curl script
curl -fsSL https://super-agentic.ai/install.sh | bashInteractive TUI (Explore)
cd your-project
superqodeAutomated QE (CI/CD)
cd your-project
superqe init
superqe run . --mode quick| Feature | Description |
|---|---|
| Multi-agent harness | Use ACP agents, BYOK providers, and local models from one interface |
| Developer TUI | Interactive sessions with compact tool activity and readable change summaries |
| Headless CLI | Run coding tasks and provider checks from scripts or terminals |
| Tool system | File, search, edit, shell, todo, MCP, and optional Monty Python REPL tools |
| Provider UX | Provider doctor, model listing, guided local provider selection, and dynamic OpenCode free model discovery |
| QE workflows | Optional SuperQE roles, sandboxes, reports, and release validation |
QE SESSION LIFECYCLE
━━━━━━━━━━━━━━━━━━━━
1. SNAPSHOT → Original code preserved
2. QE SANDBOX → Agents modify, test, break freely
3. REPORT → Document findings and fixes
4. REVERT → All changes removed automatically
5. ARTIFACTS → QRs and patches preserved
Your original code is ALWAYS restored.
For complete guides, configuration options, and API reference:
We welcome contributions! See CONTRIBUTING.md for guidelines.
git clone https://github.com/SuperagenticAI/superqode
cd superqode
uv pip install -e ".[dev]"
pytestAGPL-3.0 - Built by Superagentic AI for developers who care about code quality.