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.

cmdop-claude

~$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/*.md with paths: frontmatter so rules load lazily (only when relevant files are open). Use sidecar_add_rule to persist discovered patterns.
Docs search (FTS5) — docs_search / docs_get with BM25 full-text search. No external service.
Docs semantic search — docs_semantic_search via sqlite-vec embeddings. Build index with make 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.md per release. changelog_list / changelog_get MCP 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)

Source distribution for cmdop-claude 0.1.79
File	Size	Uploaded
cmdop_claude-0.1.79.tar.gz	522.6 kB	Mar 21, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for cmdop-claude 0.1.79
File	Interpreter	ABI	Platform	Reset
cmdop_claude-0.1.79-py3-none-any.whl 563.1 kB Mar 21, 2026	Python 3	none	any	Details

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	Mar 21, 2026
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	Mar 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.10.18`