Skip to main content

SuperQode: Super Quality Engineering for Agentic Coding Teams

Project description

SuperQode Logo

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.

PyPI Python CI License

Stars Forks Issues PRs

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

Quick Start

SuperQode: A TUI and coding agent harness for interactive exploration

# Install
uv tool install superqode

# Initialize & run
cd your-project
superqode

Follow the TUI help commands

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

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.3.tar.gz (896.5 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.3-py3-none-any.whl (1.0 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: superqode-0.1.3.tar.gz
  • Upload date:
  • Size: 896.5 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.3.tar.gz
Algorithm Hash digest
SHA256 61541acfc55bfe22cd56814c5105d8977fd9f54b463f547d7a6665d51601efe3
MD5 cbb40705fc8220fd334ca6c516387337
BLAKE2b-256 2721a08a930e6c6b74f51486ab3cae4922deb724ce031e23b04940f5ed294fa4

See more details on using hashes here.

File details

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

File metadata

  • Download URL: superqode-0.1.3-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

Hashes for superqode-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 8b4a4cc9c7bcbba69a6f472af38be262bf3de31aa6465693a21463d465efcbc8
MD5 d6eaab2a9363e2fb673e72ee36e645d9
BLAKE2b-256 4ec39dae338a7b9dba0599b81f05d74c5c5f14df792deeb95038d600a8a6183c

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