Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 37 additions & 0 deletions superqode/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
# SuperQode

SuperQode is a harness engineering coding agent, optimized for local and open
models. Unlike agents with a fixed loop, the loop SuperQode runs is a
**HarnessSpec**: a portable YAML contract in your repository that controls
model routing, tools, memory, sandbox, approvals, and checks — and that you
can version, measure with eval scorecards, and optimize.

## How sessions resolve their harness

Each ACP session picks its HarnessSpec from the project you have open:

1. `superqode.local.yaml` in the session directory
2. `harness.yaml` in the session directory
3. Specs under `.superqode/harness/` (and other conventional harness dirs)
4. The built-in coding template as a fallback

## Model configuration

The provider and model come from the spec's `model_policy.primary`
(for example `ollama/qwen3-coder`), or from the environment:

```bash
SUPERQODE_ACP_PROVIDER=ollama
SUPERQODE_ACP_MODEL=qwen3-coder
```

Run the "Set up SuperQode" authentication step to detect your hardware,
pick a local model, and generate a starter harness for the project
(`superqode local init --repo .`). Hosted/BYOK providers work through the
same spec with your usual provider API keys.

## Links

- [Documentation](https://superagenticai.github.io/superqode/)
- [Harness engineering guide](https://superagenticai.github.io/superqode/harness-engineering/)
- [Source](https://github.com/SuperagenticAI/superqode)
21 changes: 21 additions & 0 deletions superqode/agent.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
{
"id": "superqode",
"name": "SuperQode",
"version": "0.2.7",
"description": "Harness engineering coding agent for local and open models. The agent loop is a versioned HarnessSpec in your repository: model routing, tools, approvals, sandbox, and evals you can measure and optimize.",
"repository": "https://github.com/SuperagenticAI/superqode",
"website": "https://super-agentic.ai/superqode",
"authors": [
"Superagentic AI"
],
"license": "Apache-2.0",
"distribution": {
"uvx": {
"package": "superqode==0.2.7",
"args": [
"serve",
"acp"
]
}
}
}
10 changes: 10 additions & 0 deletions superqode/icon.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.