SuperQode: Super Quality Engineering for Agentic Coding Teams
Project description
SuperQode
Superior Quality-Oriented Agentic Software Development
Orchestrate, Validate, and Deploy Agentic Software with Unshakable Confidence.
Let agents break the code. Prove the fix. Ship with confidence.
📚 Documentation • 🐛 Report Bug • 💬 Discussions
What is SuperQode and SuperQE?
SuperQE is the quality paradigm and automation CLI: Super Quality Engineering for Agentic AI. It uses QE coding agents to break and validate code written by coding agents. SuperQE can spawn a team of QE agents with different testing personas in a multi-agent setup to stress your code from many angles.
SuperQode is the agentic coding harness designed to drive the SuperQE process. It delivers a Superior and Quality Optimized Developer Experience as a TUI for interactive development, debugging, and exploratory QE. SuperQode can also be used as a general development harness beyond QE.
Note (Enterprise): Enterprise adds powerful automation, deep evaluation testing, and enterprise integrations (Moltbot first; more bot integrations coming).
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 |
|---|---|
| 🎯 Quality-First | Breaks and validates code, not generates it |
| 🛡️ Sandbox Execution | Destructive testing without production risk |
| 🤖 Multi-Agent QE | Cross-validation from multiple AI perspectives |
| 📋 Quality Reports | Forensic artifacts documenting findings |
| 👥 Human-in-the-Loop | All fixes are suggestions for human review |
| 🏠 Self-Hosted | BYOK, privacy-first, no SaaS dependency |
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:
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file superqode-0.1.7.tar.gz.
File metadata
- Download URL: superqode-0.1.7.tar.gz
- Upload date:
- Size: 899.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
70d080d99655c0ee0a430166b1ba15626b910f8c8fed2a116c102d7cc322ac95
|
|
| MD5 |
14f968f18a3a3499959c23d30f257e79
|
|
| BLAKE2b-256 |
b4e34128e08bb07936f24ca0c3333513bedc13aa8bb4044d3e65392f6c4eb405
|
File details
Details for the file superqode-0.1.7-py3-none-any.whl.
File metadata
- Download URL: superqode-0.1.7-py3-none-any.whl
- Upload date:
- Size: 1.0 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
968eac2eb142b64f810736981cfb66318b5ff5ebef29d05d88f2bfc8c2f3a44f
|
|
| MD5 |
e25d1cf67033860bcf365efb05d17637
|
|
| BLAKE2b-256 |
4026a030d137e1493e9d00f8f507fbfb17a9b309650c06a550e0e3cb3b1a7717
|