Claude Code plugin that brings the codeindex CLI into your Claude Code workflow as a set of skills.
This plugin requires the codeindex CLI on your PATH. The plugin's skills shell out to it.
pipx install ai-codeindex(If you don't have pipx: python3 -m pip install --user pipx && pipx ensurepath.)
The plugin's SessionStart hook will warn you if codeindex isn't found.
Four skills (auto-namespaced under the plugin):
| Skill | Invoked when | What it does |
|---|---|---|
codeindex:arch |
User asks about project structure, "where is X implemented", "how does module Y work" | Reads README_AI.md index files to answer architecture questions |
codeindex:index |
User asks to index/scan a project, generate documentation | Walks user through codeindex init → scan-all setup |
codeindex:hooks |
User asks to auto-update docs on commit, set up git hooks | Walks user through codeindex hooks install and .codeindex.yaml hook config |
codeindex:update-guide |
User wants to refresh CLAUDE.md to latest codeindex guidance |
Delegates to codeindex claude-md update with project-aware suggestions |
Plus one SessionStart hook that verifies codeindex is on PATH.
/plugin marketplace add dreamlx/codeindex-claude
/plugin install codeindex@codeindex-claudeOnce accepted into anthropics/claude-plugins-community:
/plugin install codeindex@claude-communityClone this repo and run Claude Code with --plugin-dir:
git clone https://github.com/dreamlx/codeindex-claude
claude --plugin-dir ./codeindex-claude/plugins/codeindexNote --plugin-dir points at the plugin directory (the one containing .claude-plugin/plugin.json), i.e. plugins/codeindex, not the repo root. Use /reload-plugins to hot-reload after editing files. This local-dir path is the recommended loop for developing/testing the plugin — it bypasses the marketplace clone entirely.
/plugin marketplace update codeindex-claude
/plugin update codeindex@codeindex-claudeThe CLI itself is updated independently via pipx upgrade ai-codeindex.
If an update doesn't seem to take (you still see old behavior after
marketplace update): Claude Code's local marketplace clone can stay pinned at an old commit even whenupdatereports success. Force-refresh the clone:git -C ~/.claude/plugins/marketplaces/codeindex-claude pull --ff-onlythen retry
/plugin update. The nuclear option is/plugin marketplace remove codeindex-claude+/plugin marketplace add dreamlx/codeindex-claude(this also uninstalls then needs reinstall of the plugin).
/plugin uninstall codeindex@codeindex-claudeRemoving the plugin does NOT uninstall the ai-codeindex CLI — that's pipx uninstall ai-codeindex.
This plugin is the Claude-Code-facing layer of a deliberate two-artifact split (see codeindex ADR-006):
ai-codeindex(PyPI) — the Python CLI. Pure tool, zero Claude Code coupling. Cursor / Continue / bare-CLI users install only this.codeindex-claude(this repo) — Claude Code skills + hooks. Installs / updates / uninstalls cleanly via the platform's plugin mechanism, no~/.claude/mutation magic.
MIT. See LICENSE.