---
name: Context Index
slug: context-index
category: AI Engineering
description: "Context Index indexes 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."
github: "https://github.com/mksglu/context-mode/tree/main/skills/ctx-index"
language: TypeScript
stars: 19850
forks: 1430
install: "npx degit https://github.com/mksglu/context-mode/tree/main/skills/ctx-index ~/.claude/skills/ctx-index"
installs_to: ~/.claude/skills/ctx-index
source_path: skills/ctx-index/SKILL.md
collection_size: 11
category_size: 2451
collection_url: "https://dirskills.com/collections/mksglu/context-mode"
added: 2026-08-14T07:12:39.151Z
last_synced: 2026-08-14T07:12:39.151Z
canonical_url: "https://dirskills.com/skills/context-index"
---

# Context Index

Context Index indexes 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.

**Install:**

```bash
npx degit https://github.com/mksglu/context-mode/tree/main/skills/ctx-index ~/.claude/skills/ctx-index
```

## README

# 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:

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

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

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

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

```javascript
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.