/ctx-index

name: ctx-index
description: |
  Index a local file or directory into context-mode's persistent FTS5 knowledge base
  so future ctx_search calls can retrieve focused snippets without rereading raw files.
  Trigger: /context-mode:ctx-index
user-invocable: true

Context Mode Index

Index local project content for later search.

Instructions

1. Prefer the `ctx_index` MCP tool when it is available. 2. Ask for a path only if the user did not provide one and the current project root is ambiguous. 3. Use `path`, not large inline `content`, so file bytes do not enter the conversation. 4. For repository indexing, pass conservative bounds and a clear source label:

ctx_index({
  path: ".",
  source: "project:<name>",
  maxDepth: 5,
  maxFiles: 200
})

5. If MCP tools are unavailable, fall back to the CLI:

context-mode index . --source project:<name>

6. Report the indexed source label, file count or section count, and the matching search command:

ctx_search({ source: "project:<name>", queries: ["..."] })

Safety

• Do not index dependency directories, build outputs, secrets, or generated artifacts.
• Prefer `--exclude` or `exclude` for project-specific noisy paths.
• For broad repos, ask the user before raising `maxFiles` above 500.