CodeClone Docs¶
Structural Change Controller for AI-assisted Python development — deterministic, baseline-aware, built for CI and AI agents.
CodeClone runs one deterministic analysis pipeline and emits a canonical JSON report. Every surface — CLI, HTML, MCP, IDE — is a projection of that report. Humans and AI agents operate on the same structural facts.
The v2.1 change controller starts before the first edit: an agent declares what it intends to change, CodeClone maps the structural blast radius, verifies the patch against the declared boundary, and generates an auditable review receipt.
Documentation for the in-development v2.1 line
This site tracks the unreleased v2.1 line; for the current stable release see CodeClone v2.0.2.
New here? Follow the path¶
- Install & first run — install, analyze a repo, read the report.
- Connect your agent — wire CodeClone into your IDE or agent.
- Your first governed edit — declare → edit → verify, end to end.
Two tabs — pick one mental model
Guide — install, run, MCP workflows, IDE setup, recipes. Start at the Guide hub.
Contracts — normative guarantees, schemas, enums, payload semantics. Start at the Contracts book.
Licensing
Source code: MPL-2.0. Documentation and docs-site content: MIT.
Getting Started¶
| Goal | Start here |
|---|---|
| First install and run | Getting started |
| Understand the model | How it works |
| Terminology lookup | Terminology |
CI and Gating¶
| Goal | Start here |
|---|---|
| Baseline-aware CI | Getting started: CI setup |
| Exit codes and failure policy | Exit codes |
| Quality gates and metrics | Metrics and gates |
| Baseline contract | Baseline |
AI Agent Governance¶
| Goal | Start here |
|---|---|
| MCP usage (workflows, setup) | MCP guide |
| First governed edit (tutorial) | Your first governed edit |
| Change controller workflow | Structural Change Controller |
| Engineering Memory (scope context) | Engineering Memory |
| Trajectories and recurring patterns | Trajectories and Experiences |
| MCP interface contract | MCP interface |
IDE and Agent Clients¶
| Surface | Guide (how to) | Contract (guarantees) |
|---|---|---|
| VS Code extension | Setup | VS Code contract |
| Cursor plugin | Install & skills | Cursor contract |
| Claude Code plugin | Install | Claude Code contract |
| Codex plugin | Install | Codex contract |
| Claude Desktop bundle | Setup | Claude Desktop contract |
| SARIF & code scanning | Export | SARIF contract |
Reports¶
| Goal | Start here |
|---|---|
| Report model and schema | Report contract |
| HTML rendering | HTML render |
| Live sample | Sample report |
Maintainers & internals¶
Operating or building CodeClone itself? See Platform Observability and Corpus Analytics under the Maintainers tab.
Editions & plans — CodeClone is open source and runs locally; Team and Enterprise add scaled retention, managed options, and support. Pick the level that fits your needs: Plans and retention.