dummyindex 0.15.0

Claude Code skill — index any codebase into a .context/ folder Claude can navigate without grepping. Deterministic backbone (tree, symbols, graph, conventions) + LLM enrichment driven by the running Claude session.

dummyindex

The persistent context engine for a repo. A Claude Code skill that turns any codebase into a .context/ folder Claude can navigate without grepping — deterministic AST extraction plus a multi-agent council (dev, architect, critics) that fills in the judgment.

pip install --user dummyindex          # or: uv tool install dummyindex
dummyindex install                     # one-time, user-global
cd /path/to/your/repo
claude                                 # open Claude Code in your repo
> /dummyindex <path>                   # e.g. /dummyindex ./src

After the first run, every future Claude Code session in this repo consults .context/ before reading source at random. A SessionStart hook surfaces what drifted since the last update, and the session reconciles the index in place.

---

What it is

dummyindex runs in two modes per repo. Setup mode (one-time): /dummyindex builds .context/, installs hooks, and generates a project-tuned toolkit in .claude/ via /dummyindex-equip. Ongoing mode (every session): the spine plans, builds, and evolves — /dummyindex-plan turns a feature request into a consistency-checked proposal, /dummyindex-build drives it through the equipped agents, and /dummyindex-remember saves cross-session memory to .context/session-memory/.

Core principle: dummyindex stays the spine — it never writes production code itself. It plans, equips .context/-grounded tooling into .claude/, and orchestrates; the generated tooling + dispatched agents do the writing.

---

Install

User-global (one-time):

pip install --user dummyindex        # or: uv tool install dummyindex
dummyindex install                   # copies skill into ~/.claude/skills/dummyindex/

Per-repo (no global state):

cd /path/to/your/repo
dummyindex install --scope project   # writes .claude/skills/dummyindex/SKILL.md in this repo

To remove:

dummyindex uninstall                 # or: --scope project [--dir PATH]

---

Quickstart

Inside a Claude Code session opened in your repo:

/dummyindex                          # ingest + council, install hooks (setup mode)
/dummyindex ./src                    # scope to a subdirectory
/dummyindex-equip                    # generate project-tuned agents + skills in .claude/
/dummyindex-plan "add rate limiting" # NL → consistency-checked proposal
/dummyindex-build                    # drive the proposal's checklist to completion
/dummyindex-remember                 # save cross-session memory

CLI (no LLM cost, deterministic backbone only):

dummyindex ingest .                  # build .context/ backbone + CLAUDE.md block
dummyindex context query "how does auth work"   # ranked feature shortlist
dummyindex context rebuild --changed .          # incremental re-index
dummyindex context hooks status .              # check hook health
dummyindex context --help            # full command list

---

Docs

• docs/README.md — docs index (guide + reference + internal)
• docs/guide/ — twelve conceptual docs: architecture, data model, CLI surface, lifecycle, retrieval model, and more

---

License

MIT — see LICENSE.