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