Skip to content

SuperagenticAI/superqode

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

67 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

SuperQode TUI

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.

Note (Enterprise): Enterprise adds powerful automation, deep evaluation testing, and enterprise integrations (OpenClaw first; more bot integrations coming).

Demo Video

Watch the demo: SuperQode Demo

SuperQode Banner

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:

πŸ“š 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 by Superagentic AI for developers who care about code quality.

About

Agent-Native Coding harness for agentic quality engineering

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages