codemap_reindex

Rebuild code graph. Rescans all project files to update symbol table, dependencies, and file metadata. Use after external file changes or when graph state seems stale.

sessionreindexscanrebuildrefresh

Usage Examples

MCP Usage (for AI Agents like Claude)

json

{
  "name": "codemap_reindex",
  "arguments": {}
}

Example Output

JSON Response

json

{
  "success": true,
  "data": {
    "message": "Reindex complete",
    "before": {
      "files": 299,
      "symbols": 3099
    },
    "after": {
      "files": 305,
      "symbols": 3150
    },
    "changes": {
      "files": 6,
      "symbols": 51
    }
  }
}

ℹ️When to Use This Tool

codemap_reindex

Rebuild code graph after external file changes (git pull, npm install, etc.)
Fix stale or missing symbols in search results
Update graph after manual file edits outside CodeMap
Verify graph state after suspected corruption
Refresh counts after large refactoring

💡Common Patterns

After Git Operations

1. git pull / git checkout / git merge
2. codemap_reindex()
3. Verify changes with codemap_stats()

External version control changes don't auto-update the graph.

After npm install

1. npm install new-package
2. codemap_reindex()
3. New package files now indexed

New dependencies need graph rebuild to be searchable.

Troubleshooting Stale Data

1. Search returns outdated results
2. codemap_reindex()
3. Search again with fresh graph

When in doubt, reindex.

💡Pro Tips

Fast operation: Full reindex typically takes < 5 seconds for medium projects
Shows delta: Response includes before/after counts and changes
Safe to call anytime: No data loss, rebuilds from filesystem
Automatic tracking: File operations through CodeMap tools auto-update graph
Manual edits need reindex: Changes made outside CodeMap (IDE, git) require manual reindex

✅Best Practices

Reindex after external file operations (git, npm, manual edits)
Don't reindex unnecessarily - CodeMap auto-tracks its own changes
Check the changes delta to verify expected updates
Use as troubleshooting step when search seems stale

⚠️Common Mistakes

❌ Mistake: Reindexing after every CodeMap operation
✅ Instead: CodeMap auto-updates on its own operations, only reindex after external changes

❌ Mistake: Expecting instant graph updates after git pull
✅ Instead: Always reindex after git operations to sync graph with filesystem

❌ Mistake: Ignoring the changes delta in response
✅ Instead: Check changes to verify expected files were picked up

❌ Mistake: Using reindex to "fix" missing files
✅ Instead: Missing files might be .gitignored - check ignore patterns first

❌ Mistake: Not reindexing after switching branches
✅ Instead: Always reindex after git checkout to sync with new branch state

Usage Examples

MCP Usage (for AI Agents like Claude)

Example Output

JSON Response

Related Tools

codemap_session_stats

codemap_session_orient

codemap_search_scan