superqode 0.1.23

SuperQode: Multi-Agent Coding Agent Harness

SuperQode

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

---

What is SuperQode?

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.

Demo Video

Watch the demo: SuperQode Demo

Quick Start

Installation

Primary (Recommended)

# Using uv (best performance)
uv tool install superqode

# Or using pip
pip install superqode

Alternate (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 | bash

Run SuperQode

Interactive TUI (Explore)

cd your-project
superqode

Automated QE (CI/CD)

cd your-project
superqe init
superqe run . --mode quick

Key Features

Feature	Description
Multi-agent harness	Use ACP agents, BYOK providers, and local models from one interface
Pluggable runtimes	Swap the agent loop: SuperQode native (default), Google ADK, or OpenAI Agents SDK
Developer TUI	Interactive sessions with wrapped prompts, quiet streaming logs, 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

How It Works

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.

Documentation

For complete guides, configuration options, and API reference:

📚 View Full Documentation →

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

git clone https://github.com/SuperagenticAI/superqode
cd superqode
uv pip install -e ".[dev]"
pytest

License

AGPL-3.0 - Built by Superagentic AI for developers who care about code quality.