Turbo Index

Resolve PLUGIN_DIR to the absolute directory two levels above this skill file, resolving symlinks. Set it in each shell invocation; keep the working directory in the target repository.

1. Check dependencies with bash "$PLUGIN_DIR/scripts/install-deps.sh" --check-only. Install missing dependencies using the same script without --check-only when authorized.

2. Build the memory executable and initialize the current project's memory:

   bash "$PLUGIN_DIR/scripts/setup-memory.sh"
   

3. For a standalone skills installation, register MCP for the client being used:

   bash "$PLUGIN_DIR/scripts/setup-mcp.sh" --client codex
   # Use --client claude or --client both as appropriate.
   

   Preserve existing servers. If qmd is already registered, inspect it before changing it. The project adapter must run scripts/qmd-mcp.sh, not an old global qmd mcp command. See the README migration instructions.

4. Index current Markdown documentation:

   python3 "$PLUGIN_DIR/scripts/turbo.py" index
   

   This uses a dedicated QMD index/collection for this checkout, snapshots allowed Markdown files, respects ignore files and excludes hidden paths, symlinks and sensitive filenames. It does not embed by default. Use index --embed when semantic search is wanted; model downloads can be large. Embedding failure leaves keyword search available.

5. Verify with a real project term:

   python3 "$PLUGIN_DIR/scripts/turbo.py" search "authentication"
   python3 "$PLUGIN_DIR/scripts/turbo.py" doctor
   

Report what actually succeeded, missing dependencies and stale indexes. Do not claim measured token savings without measurements. Index refresh is explicit and never runs in a prompt hook.

Optional: install hooks with bash "$PLUGIN_DIR/scripts/setup-hooks.sh" --client codex --rag --memory (or claude). For Claude only, setup-file-suggestion.sh adds file suggestions. Cartographer is optional; use it only if available and useful.