Skip to main content

SuperQode: Super Quality Engineering for Agentic Coding Teams

Project description

SuperQode Logo

SuperQode

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

PyPI Python CI License

Stars Forks Issues PRs

📚 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

superqode-0.1.1.tar.gz (842.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

superqode-0.1.1-py3-none-any.whl (971.0 kB view details)

Uploaded Python 3

File details

Details for the file superqode-0.1.1.tar.gz.

File metadata

  • Download URL: superqode-0.1.1.tar.gz
  • Upload date:
  • Size: 842.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.7

File hashes

Hashes for superqode-0.1.1.tar.gz
Algorithm Hash digest
SHA256 df63ee36b50b19305463d98120057e7df8cc6a77082d1c4325ee354edd204732
MD5 945ce4f46c88af598891424a5f662863
BLAKE2b-256 c47d9225036771c590c2656074a6fd1bef7fe934cad3e31e468e071e89face32

See more details on using hashes here.

File details

Details for the file superqode-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: superqode-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 971.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.7

File hashes

Hashes for superqode-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 a583b9d3410f1ba37b4125b9a33e2056e6c2afe86bd1ea3a50c9d4b94f59de28
MD5 32adef02dcd86b5f3b15575555f73f37
BLAKE2b-256 9ff1daa4b655dd0bb967566ca13382c011ec41de9d4ce40e3c6b9e3b30b01ab0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page