superqode 0.1.0

SuperQode: Super Quality Engineering for Agentic Coding Teams

SuperQode

Super Quality Engineering for Agentic AI
Let agents break the code. Prove the fix. Ship with confidence.

📚 Documentation • 🐛 Report Bug • 💬 Discussions

---

What is SuperQode?

SuperQode is a quality-oriented harness for AI coding agents. Multiple QE agents attack and validate code in sandboxes before it ships—adversarial validation with evidence, where humans remain in control.

Component	Purpose
superqe	Quality Engineering for Agentic Coding Teams
superqode	Exploratory coding agent harness beyond QE

Quick Start

SuperQE : A CLI for automated QE in CI/CD

# Install
uv tool install superqode

# Initialize & run
cd your-project
superqe init
superqe run . --mode quick

SuperQode: A TUI and coding agent harnedd for interactive exploration

# Install
uv tool install superqode

# Initialize & run
cd your-project
superqode

Follow the TUI help commands

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:

📚 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 with ❤️ for developers who care about code quality.