stellarion_index_files

Indexes a specific set of files, adding them to or updating them in the code graph. Use this when you've changed a few files and want them indexed immediately without waiting for background indexing or triggering a full workspace reindex.

When to Use

• You just created or modified specific files and want them searchable immediately
• You want to add files that were excluded from the initial index
• You need to refresh the index for specific files after editing them
• You want fine-grained control over what gets indexed

Parameters

Examples

Index newly created files

Natural language:

Index the files I just created: src/auth/oauth.ts and src/auth/providers.ts

MCP call:

{
  "tool": "stellarion_index_files",
  "arguments": {
    "files": [
      "/Users/dev/project/src/auth/oauth.ts",
      "/Users/dev/project/src/auth/providers.ts"
    ]
  }
}

Re-index a modified file

Natural language:

I just refactored src/utils/format.py, update the index for it

MCP call:

{
  "tool": "stellarion_index_files",
  "arguments": {
    "files": [
      "/Users/dev/project/src/utils/format.py"
    ]
  }
}

Output Format

Returns indexing results per file:

• indexed — List of successfully indexed files with symbol counts
• errors — Any files that failed to parse, with error details

Tips

• Paths must be absolute. Relative paths will not resolve correctly.
• This is faster than stellarion_reindex_workspace when you only need to update a handful of files.
• Use this after code generation or scaffolding to immediately make new files searchable.
• If you need to index an entire directory, use stellarion_index_directory instead.