cmdop-claude
Self-maintaining .claude/ runtime for Claude Code. Keeps your project documentation accurate, your context lean, and your LLM session aware of what matters — automatically.
~$0.003 per full cycle (scan → review → fix → map) using DeepSeek V3.2.
What it does
- Documentation review — LLM finds stale docs, contradictions, coverage gaps, abandoned plans. Runs automatically once per day.
- Project map — annotates directories with one-sentence descriptions. Cached by SHA256; only changed dirs cost tokens.
- Task queue — review findings become structured tasks (
T-001.md, ...). Top pending items injected into every prompt automatically. - Auto-fix — LLM generates targeted file edits for any task. Preview diff or apply directly.
- Project init — bootstraps
CLAUDE.md+rules/from scratch using a two-step LLM pipeline. - Rules system — generates
.claude/rules/*.mdwithpaths:frontmatter so rules load lazily (only when relevant files are open). Usesidecar_add_ruleto persist discovered patterns. - Docs search (FTS5) —
docs_search/docs_getwith BM25 full-text search. No external service. - Docs semantic search —
docs_semantic_searchvia sqlite-vec embeddings. Build index withmake embed-docs. - Plugin browser — searches Smithery + Official MCP registries (~1000 plugins).
- Skill Studio — install, browse, edit Claude Code skills from claude-plugins.dev.
- Changelog system —
changelog/vX.Y.Z.mdper release.changelog_list/changelog_getMCP tools. - Auto-update — checks PyPI once per 6 hours, upgrades silently in background.
- Streamlit dashboard — 12-tab UI for all of the above.
Install
pip install cmdop-claude
# With Streamlit dashboard
pip install cmdop-claude
Quick Start
pip install cmdop-claude
cd your-project
python -m cmdop_claude.sidecar.hook setup
setup registers the MCP server, installs hooks, configures .claude/, and generates docs if none exist.
Then set your API key:
export OPENROUTER_API_KEY=sk-or-... # OpenRouter (recommended)
export OPENAI_API_KEY=sk-... # OpenAI
export SDKROUTER_API_KEY=... # SDKRouter
Or configure it in the dashboard: make run → Settings & Security → LLM Provider.
Uninstall
python -m cmdop_claude.sidecar.hook unregister
MCP Tools (quick reference)
| Tool | Description |
|---|---|
sidecar_scan |
Run documentation review |
sidecar_map |
Generate/update project map |
sidecar_tasks |
List/create/update tasks |
sidecar_fix |
Generate fix for a task |
sidecar_init |
Bootstrap .claude/ for bare projects |
sidecar_add_rule |
Add/update a rule in .claude/rules/ |
docs_search |
Full-text search across bundled + custom docs |
docs_semantic_search |
Semantic vector search over docs |
changelog_list / changelog_get |
Browse release history |
→ Full table with all 19 tools: docs/mcp-tools.md
Dashboard
make run # http://localhost:8501
12 tabs: Overview, Project Map, Task Queue, Changelog, Skills, Plugins, Docs, MCP, Hooks, Settings, Sidecar, Trigger Graph.
Docs
- MCP Tools — all 19 tools, query syntax
- Configuration — LLM providers, env vars, docs sources, vector index
- CLI Reference — all commands + Python API
- Architecture — how it works, source tree, file layout
- Cost — token usage per operation
Testing
make test # 455+ tests
License
MIT
Metadata
Release files for cmdop-claude 0.1.79
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| cmdop_claude-0.1.79.tar.gz | 522.6 kB | Without provenance | Details for cmdop_claude-0.1.79.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| cmdop_claude-0.1.79-py3-none-any.whl | Python 3 | none | any | Details for cmdop_claude-0.1.79-py3-none-any.whl |
Total release size: 1.1 MB
Release files / cmdop_claude-0.1.79.tar.gz
| Download URL | cmdop_claude-0.1.79.tar.gz |
|---|---|
| Size | 522.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7ceaa198ffd35057b9cd0f15d837c920d2ad84995e29e5fcf948a0950baa44c9
|
|
BLAKE2b-256 checksum How to use checksums |
06766341cd56cc5c6d0b637091fdd64db303a4014fec279e59c8f725f4924439
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.18
|
Release files / cmdop_claude-0.1.79-py3-none-any.whl
| Download URL | cmdop_claude-0.1.79-py3-none-any.whl |
|---|---|
| Size | 563.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a8126b7c2c0e2ddbadd1ecf4c7d7add4d461a011c3f0854078db2d8e82bc49fd
|
|
BLAKE2b-256 checksum How to use checksums |
638f0df3a8aca8cb0b7f2a2f19e09ae74e96672a5bf2000bac3ec9f9700b95b0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.18
|
Security for cmdop-claude 0.1.79
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.