superqode 0.1.24

SuperQode: Multi-Agent Coding Agent Harness

SuperQode

Production coding harness for local models, BYOK providers, and pluggable agent runtimes
Define the harness, choose the runtime, control the tools, and keep coding sessions readable.
Bring your own model, runtime, tools, and harness.

📚 Documentation • 🐛 Report Bug • 💬 Discussions

---

What is SuperQode?

SuperQode is a production 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 runtime they prefer, run file/search/edit/shell tools under policy, and get concise summaries of what changed.

The v2 direction is harness-first: SuperQode owns the kernel for sessions, tools, runtimes, model policies, sandboxing, typed outputs, workflow execution, validation, events, and backend adapters. Higher-level workflows can be built on top through A2A later without changing the core identity.

Note (Enterprise): Enterprise adds deeper automation, evaluation testing, and enterprise integrations.

Core Concepts

SuperQode separates the pieces of an agent system so teams can change one piece without rewriting the rest.

Concept	What it means in SuperQode
Harness	The full contract for a run: flavor, model policy, tools, sandbox, workflow, output, events, and validation
Runtime	The engine that executes the harness, such as the native loop, Google ADK, OpenAI Agents SDK, or DeepAgents
Flavor	The kind of harness being run, such as tool-rich coding or model-only no-tool
Tools	Capabilities granted by policy, including file, search, edit, shell, MCP, todo, and validation tools
Model policy	The model-specific behavior for prompt level, temperature, reasoning, tool surface, history, and iteration limits
Framework adapter	A bridge that lets an external agent framework run behind the SuperQode harness contract

The harness is the product contract. Runtimes and framework adapters are execution choices behind that contract.

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)

# 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

Headless coding harness

cd your-project
superqode --print "inspect this repository and suggest the smallest next step"

Key Features

Feature	Description
HarnessSpec	Define coding, no-tool, local-model, and custom harness behavior with one declarative contract
Harness kernel	Run sessions with normalized events, run records, backend dispatch, typed outputs, and workflow execution
Pluggable runtimes	Swap the agent loop: SuperQode native, Google ADK, OpenAI Agents SDK, or optional DeepAgents
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
Sandbox contract	Use local sandbox policy for read, write, shell, command, grep, glob, and edit access
Typed outputs	Ask a harness run to return validated structured data using explicit result delimiters
Workflow engine	Run single, chain, parallel, router, orchestrator, and evaluator-optimizer workflows
Model policies	First-class Gemma4, DS4, coding, and no-tool policy profiles for local and hosted models
Provider UX	Provider doctor, model listing, guided local provider selection, and dynamic OpenCode free model discovery
Harness flavors	Tool-rich coding and model-only no-tool profiles, with room for Bring Your Own Harness specs

How It Works

HARNESS LIFECYCLE
━━━━━━━━━━━━━━━━━
1. SPEC       Choose coding, no-tool, local-model, or custom harness behavior
2. MODEL      Resolve policy for Gemma4, DS4, hosted models, or model-only runs
3. RUNTIME    Run on builtin, OpenAI Agents, Google ADK, DeepAgents, or another backend
4. TOOLS      Attach file, search, edit, shell, MCP, or no tools
5. SESSION    Stream events, persist history, compact context, and store runs
6. OUTPUT     Return text, typed data, workflow results, and validation state

The default coding harness keeps repository work practical. The no-tool harness lets you bet directly on model capability. Optional runtimes let teams bring their preferred agent framework without replacing the SuperQode harness contract.

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.