Metadata-Version: 2.4
Name: superqode
Version: 0.1.2
Summary: SuperQode: Super Quality Engineering for Agentic Coding Teams
Author-email: Shashi Jagtap <shashi@super-agentic.ai>, Shashi Jagtap <shashikant.jagtap@icloud.com>
Maintainer-email: Shashi Jagtap <team@super-agentic.ai>, Shashi Jagtap <shashikant.jagtap@icloud.com>
Project-URL: Repository, https://github.com/SuperagenticAI/superqode
Project-URL: Documentation, https://superagenticai.github.io/superqode/
Project-URL: Issues, https://github.com/SuperagenticAI/superqode/issues
Project-URL: Changelog, https://github.com/SuperagenticAI/superqode/blob/main/CHANGELOG.md
Keywords: ai,coding-agents,multi-agent,orchestration,sdlc,automation,mcp,kubernetes,superqode
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pyyaml>=6.0
Requires-Dist: click>=8.0.0
Requires-Dist: litellm>=1.80.11
Requires-Dist: agent-client-protocol>=0.7.0
Requires-Dist: prompt_toolkit>=3.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: textual>=0.47.0
Requires-Dist: mcp>=1.25.0
Requires-Dist: anyio>=4.0.0
Requires-Dist: httpx>=0.24.0
Requires-Dist: httpx-sse>=0.4.0
Requires-Dist: codeoptix>=0.1.0
Requires-Dist: superopt>=0.1.1
Provides-Extra: mlx
Requires-Dist: mlx-lm<0.30.0,>=0.28.3; python_version < "3.14" and extra == "mlx"
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: coverage>=7.0.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Requires-Dist: pre-commit>=3.0.0; extra == "dev"
Provides-Extra: testing
Requires-Dist: pytest>=7.0.0; extra == "testing"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "testing"
Requires-Dist: pytest-cov>=4.0.0; extra == "testing"
Requires-Dist: coverage>=7.0.0; extra == "testing"
Requires-Dist: bandit>=1.7.0; extra == "testing"
Requires-Dist: httpx>=0.24.0; extra == "testing"
Provides-Extra: linters
Requires-Dist: bandit>=1.7.5; extra == "linters"
Requires-Dist: pylint>=3.0.0; extra == "linters"
Requires-Dist: flake8>=6.1.0; extra == "linters"
Requires-Dist: safety>=2.3.0; extra == "linters"
Requires-Dist: pip-audit>=2.6.0; extra == "linters"
Provides-Extra: ui-testing
Requires-Dist: selenium>=4.0.0; extra == "ui-testing"
Requires-Dist: playwright>=1.0.0; extra == "ui-testing"
Provides-Extra: performance
Requires-Dist: locust>=2.0.0; extra == "performance"
Provides-Extra: docs
Requires-Dist: mkdocs>=1.5.0; extra == "docs"
Requires-Dist: mkdocs-material>=9.4.0; extra == "docs"
Requires-Dist: pymdown-extensions>=10.0.0; extra == "docs"
Requires-Dist: mkdocs-minify-plugin>=0.7.0; extra == "docs"
Dynamic: license-file

<p align="center">
   <img src="https://raw.githubusercontent.com/SuperagenticAI/superqode/main/docs/assets/superqode.png" alt="SuperQode Logo" width="200">
</p>

<h1 align="center">SuperQode</h1>

<p align="center">
  <strong>Super Quality Engineering for Agentic Coding Teams</strong><br>
  <em>Let agents break the code. Prove the fix. Ship with confidence.</em>
</p>

<p align="center">
  <a href="https://pypi.org/project/superqode/"><img src="https://img.shields.io/pypi/v/superqode?style=flat-square&color=blue" alt="PyPI"></a>
  <a href="https://pypi.org/project/superqode/"><img src="https://img.shields.io/pypi/pyversions/superqode?style=flat-square" alt="Python"></a>
  <a href="https://github.com/SuperagenticAI/superqode/actions"><img src="https://img.shields.io/github/actions/workflow/status/SuperagenticAI/superqode/superqe.yml?style=flat-square&label=CI" alt="CI"></a>
  <a href="https://github.com/SuperagenticAI/superqode/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-AGPL--3.0-green?style=flat-square" alt="License"></a>
</p>

<p align="center">
  <a href="https://github.com/SuperagenticAI/superqode/stargazers"><img src="https://img.shields.io/github/stars/SuperagenticAI/superqode?style=flat-square" alt="Stars"></a>
  <a href="https://github.com/SuperagenticAI/superqode/network/members"><img src="https://img.shields.io/github/forks/SuperagenticAI/superqode?style=flat-square" alt="Forks"></a>
  <a href="https://github.com/SuperagenticAI/superqode/issues"><img src="https://img.shields.io/github/issues/SuperagenticAI/superqode?style=flat-square" alt="Issues"></a>
  <a href="https://github.com/SuperagenticAI/superqode/pulls"><img src="https://img.shields.io/github/issues-pr/SuperagenticAI/superqode?style=flat-square" alt="PRs"></a>
</p>

<p align="center">
  <a href="https://superagenticai.github.io/superqode/">📚 Documentation</a> •
  <a href="https://github.com/SuperagenticAI/superqode/issues">🐛 Report Bug</a> •
  <a href="https://github.com/SuperagenticAI/superqode/discussions">💬 Discussions</a>
</p>

---

## 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

```bash
# 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 

```bash
# 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 →](https://superagenticai.github.io/superqode/)**

## Contributing

We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

```bash
git clone https://github.com/SuperagenticAI/superqode
cd superqode
uv pip install -e ".[dev]"
pytest
```

## License

[AGPL-3.0](LICENSE) — Built with ❤️ for developers who care about code quality.
