indexio
Local code search engine that indexes repos once for AI agents via MCP.
Tested on LinuxKnown vulnerabilities
Use it
Before you install: known vulnerabilities
pickfit found 6 known high or critical vulnerabilities (8 findings, one per affected package version) in the packages a fresh install brings (OSV.dev, 3 Nov 2026). Weigh this before you install it.
crates:gix 0.66.0gitoxide: CommandForbiddenInModulesConfiguration Bypass in gix_submodule::File::update() Enables Arbitrary Command Execution via .gitmodules (GHSA-f26g-jm89-4g65, high, fixed in 0.83.0)crates:gix-fs 0.11.3gix-fs: Symlink prefix-reuse allows worktree escape during checkout (GHSA-f89h-2fjh-2r9q, high, fixed in 0.21.1)
See 6 more
crates:gix 0.66.0— GHSA-fr8x-3vfx-f45h (high), fixed in 0.83.0crates:gix 0.66.0— GHSA-p3hw-mv63-rf9w (high), fixed in 0.83.0crates:gix 0.66.0— GHSA-pg4w-g64p-qwhj (high), fixed in 0.83.0crates:gix-pack 0.53.0— GHSA-x494-mj8g-cj27 (high), fixed in 0.69.0crates:gix-validate 0.9.4— GHSA-p3hw-mv63-rf9w (high), fixed in 0.11.1crates:gix-validate 0.10.1— GHSA-p3hw-mv63-rf9w (high), fixed in 0.11.1
Linux x86_64
You need first
- System packages:
git
install via uv tool install indexio-cli
uv tool install indexio-cli
Check that it works
indexio --version 2>&1The output should contain “indexio 0.1.10”.
First thing to try
mkdir -p /tmp/sample_repo && cd /tmp/sample_repo && git init -q && git config user.email "test@test.com" && git config user.name "test" && cat > main.py <<'PY'
# Sample repo for indexio testing
def hello(name):
"""Greet someone"""
return f"Hello {name}"
def add(a, b):
return a + b
# TODO: refactor this function
def old_function():
pass
HELLO_CONSTANT = 42
PY
cat > utils.py <<'PY'
def helper():
return hello("world")
def caller_of_add():
return add(1,2)
PY
# need import for helper to reference hello - add import
printf 'from main import hello, add\n' | cat - utils.py > utils.py.tmp && mv utils.py.tmp utils.py
git add . && git commit -qm "initial" && ls -la
indexio add /tmp/sample_repo 2>&1 && indexio stats 2>&1indexio search "TODO" --limit 3 2>&1Add it to your agent
claude mcp add indexio -- indexio mcpJSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"indexio": {
"command": "indexio",
"args": [
"mcp"
]
}
}
}Run indexio add <repo> to index a repository, then indexio mcp to serve it to your MCP client.
What it does
- Search code by text, meaning, or bothTested
How to use it
- Index your repository with
indexio add <repo>and check it withindexio stats. - Start the MCP server with
indexio mcpand connect your MCP client. - Call the
code_searchtool with a query such as <your text> and an optional limit.
- Index your repository with
- Find where a symbol is defined and who calls itTested
How to use it
- Index your repository with
indexio add <repo>. - Start the MCP server with
indexio mcpand connect your MCP client. - Call
find_symbolwith the symbol name to find its definition, orwho_callswith the name to list its callers.
- Index your repository with
- See the impact of changing a symbol or diffNot shown working
- Serve the code index over MCP and an HTTP APINot tested
How far pickfit got
Linux x86_64
- Installs
- Connects
- 2 of 4 features work
- Works offline
macOS and Windows: the project says it runs there; pickfit hasn’t tried it.
Good for
- find where a symbol is defined
- answer semantic questions about code
- find who calls a symbol and impact of change
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
An MCP client called one of its tools
- Replayed from scratch
- Works offline
- Checked on 1 Nov 2026
- Version 0.1.10
An MCP client handshake over stdio listed 13 tools, and a call to code_search returned a result.