Welcome to CodeClone Discussions 👋

[orenlab]

This is the place for questions, ideas, and feedback around CodeClone — a structural review layer for Python with baseline-aware CI gating and MCP support.

Categories

	Category	What goes here
📣	Announcements	Releases, breaking changes, deprecations
🙋	Q&A	Usage questions: CLI flags, baseline workflow, gate configuration, MCP setup
💡	Ideas	Feature requests — please include the use-case, not just the wish
🐛	Bug Reports	Unexpected behavior, wrong exit codes, report rendering issues
🔁	Integrations	CI/CD setups, pre-commit configs, IDE and agent workflows
🗣	General	Anything else

Before you post

Bug? → Check open issues first. If it's reproducible and clearly a defect, open an issue directly — it's faster than a discussion thread.

Exit code unexpected? → Include the --ci / gate flags used, whether a baseline is loaded, and the full stderr output.

MCP question? → Specify transport (stdio / streamable-http), client (VS Code / Claude Desktop / Codex / custom), and whether codeclone-mcp starts without error in isolation.

Feature idea? → Describe the workflow gap, not the implementation. "I need X because CI currently does Y and that means Z" is far more useful than a bare feature name.

Quick orientation

# install
uv tool install codeclone           # recommended
pip install codeclone               # pip fallback
uv tool install "codeclone[mcp]"    # with MCP server

# first run
codeclone .                         # analyze
codeclone . --update-baseline       # establish CI reference point
codeclone . --ci                    # baseline-aware CI gate

→ Full docs · Baseline contract · Quality gates · MCP interface · Exit codes · Live sample report

Exit code cheatsheet

Code	Meaning
0	Clean
2	Contract error — untrusted baseline, invalid config
3	Gate failure — new clones or threshold exceeded
5	Internal error

Exit 2 takes precedence over 3. If you're seeing 2 in CI, start with the baseline trust check before looking at gate flags.

---

Maintained by @orenlab · Security issues → SECURITY.md