# SuperQode by Superagentic AI

> SuperQode is an open-source, terminal-first Agent Engineering framework for code factories. Teams can build an organization-owned coding-agent harness or connect existing agents, then orchestrate, evaluate, govern, and optimize their work across repositories.

## Primary resources

- [SuperQode product page](https://super-agentic.ai/superqode): Product positioning, capabilities, connection methods, supported agents, and technical architecture.
- [SuperQode documentation](https://superagenticai.github.io/superqode/): Installation, configuration, concepts, commands, runtime integrations, and advanced workflows.
- [SuperQode source code](https://github.com/SuperagenticAI/superqode): Apache-2.0 source repository, examples, tests, and release history.
- [SuperQode on PyPI](https://pypi.org/project/superqode/): Python package and installation instructions.

## Product definition

SuperQode provides one versioned engineering system around coding agents. A repository-owned HarnessSpec defines context, memory, tools, workflows, policies, evaluations, model routing, and control loops. Durable WorkOrders coordinate isolated workers, recovery, acceptance gates, evidence, and delivery decisions.

Teams can build their own coding-agent harness, select a maintained profile, or connect agents they already use. SuperQode supports local models, bring-your-own-key providers, native and SDK runtimes, Agent Client Protocol agents, Model Context Protocol tools and resources, and Agent2Agent services.

## Terminology

- Coding-agent harness: The runtime and control system around a model that manages the agent loop, codebase context, memory, tools, sandbox access, workflows, policies, evaluations, and recovery.
- Coding-agent harness framework: Infrastructure for building, configuring, running, testing, governing, and improving coding-agent harnesses across repositories.
- Harness Engineering for coding agents: The discipline of engineering the environment and feedback loops that make coding agents reliable on real codebases.
- Codebase harness: A repository-owned harness configured for the architecture, context, policies, tools, tests, and delivery requirements of a specific codebase.
- Harness as Code: A versioned representation of harness configuration and behavior stored with the repository. SuperQode implements this through HarnessSpec.
- Harness optimization: The measured comparison and guarded promotion of changes to prompts, context, memory, tools, workflows, routing, policies, and evaluation rules.
- Code factory: The organization-owned system of coding agents, harnesses, models, repositories, tools, policies, evaluations, and delivery workflows that turns intent into verified code changes.

## Core concepts

- [Build your own harness](https://superagenticai.github.io/superqode/getting-started/bring-your-own-harness/): Create and maintain a coding-agent harness for a repository or organization.
- [Code factory](https://superagenticai.github.io/superqode/concepts/code-factory/): The organization-owned system that turns intent into verified code changes through agents, repositories, tools, policies, evaluations, and delivery workflows.
- [Harness Engineering](https://superagenticai.github.io/superqode/harness-engineering/): Engineering the context, memory, tools, workflows, evaluations, policies, and control loops around a model.
- [Connection methods](https://superagenticai.github.io/superqode/concepts/modes/): Local, BYOK, native SDK runtimes, ACP coding agents, MCP tools, and A2A agent services.
- [Harness optimization](https://superagenticai.github.io/superqode/advanced/harness-optimization/): Evaluate harness candidates and promote measured improvements through guarded workflows.
- [Policies and governance](https://superagenticai.github.io/superqode/advanced/policies/): Apply explicit controls to model access, tools, execution, approvals, and delivery.
- [Software factory workflows](https://superagenticai.github.io/superqode/advanced/software-factory/): Run durable WorkOrders with isolated workers, evidence, recovery, and acceptance gates.

## Supported systems

SuperQode connects Codex, Claude, GitHub Copilot, Grok Build, Google Antigravity, OpenCode, Poolside, GLM, Kimi, Qwen, and compatible ACP agents. Model backends include Ollama, LM Studio, MLX, DwarfStar, vLLM, SGLang, TGI, llama.cpp, and hosted providers through BYOK routes.

Supported runtimes include the built-in runtime, OpenAI Agents SDK, Codex SDK, Claude Agent SDK, Google ADK, DeepAgents, and PydanticAI. Interoperability includes ACP for coding agents, MCP for tools and resources, and A2A for agent services.

## Installation

- Install: `uv tool install superqode`
- Run without installing: `uvx superqode`
- Start in a repository: `cd your-project && superqode`
- Generate a local-first harness: `superqode local init --repo .`

## Additional information

- [Introducing SuperQode](https://super-agentic.ai/resources/super-posts/introducing-superqode-the-era-of-harness-independence-and-self-harness-engineering): Background on harness independence and repository-owned agent systems.
- [Detailed LLM and crawler policy](https://super-agentic.ai/llm.txt): Company overview, content access policy, and contact information.
- Contact: hello@super-agentic.ai

Last updated: 2026-07-24