Shaktiman

Local-first code context engine for coding agents.

Shaktiman indexes your codebase and exposes MCP tools (search, symbols, dependencies, context) that let Claude Code and other agents assemble exactly the right code context — fitted to a token budget.

• Tree-sitter parsing — functions, classes, symbols, imports, call graphs
• Hybrid search — keyword (FTS5) + semantic (vector) + structural + change signals
• Budget-fitted context — ask for 4K tokens, get 4K tokens of the most relevant code
• Live updates — file watcher re-indexes on save

📖 Full documentation: shaktiman.dev

Quick Start

git clone git@github.com:midhunkrishna/shaktiman.git
cd shaktiman
go build -tags "sqlite_fts5 sqlite bruteforce hnsw" -o shaktimand ./cmd/shaktimand

Then wire it into Claude Code via .mcp.json. See Getting Started for the full walkthrough.

Documentation

Installation	Prerequisites, build tags, Ollama setup
Claude Code setup	.mcp.json config + CLAUDE.md template
MCP tools	search, context, symbols, dependencies, diff, summary
CLI reference	All commands and flags
Configuration	.shaktiman/shaktiman.toml options
Backends	SQLite, PostgreSQL, pgvector, Qdrant, HNSW
Integrations	Claude Code, Cursor, Zed, custom agents

Supported Languages

TypeScript, JavaScript, Python, Go, Rust, Java, Ruby, ERB, Shell (bash). See supported languages for details and instructions on adding new ones.

Contributing

# Build, test, vet (default backends)
go build -tags "sqlite_fts5 sqlite bruteforce hnsw" ./...
go test -race -tags "sqlite_fts5 sqlite bruteforce hnsw" ./...
go vet -tags "sqlite_fts5 sqlite bruteforce hnsw" ./...

See Contributing for project structure, backend build tags, and language-addition steps.

License

MIT