# crabcc

> Symbol index for AI coding agents. A small Rust CLI + MCP server that indexes a
> repo's symbols into SQLite and answers four queries — sym, refs, callers,
> outline — as typed JSON, up to 4412× faster than grep and ~85% fewer tokens.

## Docs

- [Full page as Markdown](./crabcc.md): the complete landing page, agent-readable.
- [MCP tool schema](./mcp-schema.json): JSON-RPC 2.0 tools (sym, refs, callers, outline).

## Primitives

- [sym](./crabcc.md#the-four-primitives): where is a symbol defined? (kind, file, line)
- [refs](./crabcc.md#the-four-primitives): every reference to a symbol, deduped by file
- [callers](./crabcc.md#the-four-primitives): who calls this function (call graph, upward)
- [outline](./crabcc.md#the-four-primitives): the symbols of a file, in order

## Install

- `cargo install crabcc`
- Repo: https://github.com/crabcc-labs/crabcc
- Crate: https://crates.io/crates/crabcc

## Notes

- Shape output with `--count`, `--files-only`, `--limit` — pick the smallest shape the question allows.
- crabcc indexes symbols, not arbitrary text. For prose/TODO search, use `rg`.