/* code intelligence for ai agents */

sverklo

Your AI agent wastes 70% of tokens reading irrelevant files. Sverklo indexes your codebase locally — hybrid semantic search with PageRank ranking and persistent memory. Zero config.

~/your-project claude code

# install sverklo and set it up in any project $ npm install -g sverklo $ cd your-project && sverklo init ✓ .claude/mcp.json ✓ .claude/settings.local.json ✓ CLAUDE.md # ask your agent anything — sverklo is preferred automatically > how does the auth middleware work? ⚡ sverklo_search query="authentication middleware" ─ src/middleware/auth.ts:42 validateToken() score: 0.89 ─ src/routes/auth.ts:18 requireAuth() score: 0.84 ─ src/lib/jwt.ts:12 verifyJWT() score: 0.81 ✓ 3 results in 23ms — 847 files searched, 2,431 tokens used

/* how it works */

indexed.
ranked.
remembered.

hybrid search

BM25 for precision, semantic embeddings for recall, PageRank for structural importance — fused via RRF. Faster and more accurate than grep.

local embeddings

all-MiniLM-L6-v2 via ONNX runtime. 384-dimensional vectors generated on your machine. No API calls, no data leaves your laptop.

pagerank ranking

Files that are imported by many others rank higher. Your agent finds the actually-important code first, not just keyword matches.

persistent memory

Save decisions, patterns, and preferences with git-state linking. Stale memories flagged automatically when referenced files change.

incremental

File watcher updates the index on every save. Dependency graph and PageRank recompute in real time. Always fresh.

ten languages

TypeScript, JavaScript, Python, Go, Rust, Java, C, C++, Ruby, PHP. More coming. Structural parsing for each.

/* persistent memory */

your agent
finally
remembers.

Every AI coding session starts from zero. Decisions vanish after context compaction. Sverklo fixes this with persistent memory linked to git state.

On sverklo init, your existing CLAUDE.md, .cursorrules, and ADRs get parsed into searchable memories — categorized, tagged, and embedded automatically.

Tell your agent to remember new things as they come up. Ask later. It's already there.

session 0 · day one import

# bring your existing docs — sverklo ingests them automatically $ sverklo init ✓ .claude/mcp.json · .claude/settings.local.json · CLAUDE.md Scanning for existing project knowledge... ✓ imported 18 memories from: · CLAUDE.md (12) — conventions, tech stack · .cursorrules (3) — style preferences · docs/adr/001-prisma.md — decision, tagged adr · docs/adr/002-auth.md — decision, tagged adr · CONTRIBUTING.md (1) — review process

session 1 · tuesday remember

> we decided to use Prisma for the ORM because it gives better TypeScript types than Drizzle ⚡ sverklo_remember category="decision" content: "We chose Prisma over Drizzle for better TypeScript types" tags: ["database", "orm"] git: main@a3f29e1 confidence: 1.0 ✓ memory #42 saved

session 2 · thursday (new conversation) recall

# session start — sverklo://context auto-injected Loaded 3 memories: ORM choice, auth pattern, API conventions > add a new API endpoint for user profiles # Claude knows: Prisma for DB (from memory #42) # Claude knows: JWT validation before DB calls (from memory #43) ⚡ writes endpoint with Prisma + JWT validation — no rediscovery

bring your own docs

Auto-imports memories from CLAUDE.md, .cursorrules, AGENTS.md, CONTRIBUTING.md, and ADRs on init. Your existing project knowledge becomes semantically searchable instantly.

git-state linked

Every memory carries the git SHA and branch from when it was created. Know what the code looked like when the decision was made.

staleness detection

If a memory references a file that no longer exists, it's flagged as stale. No more advice based on deleted code.

semantic recall

Memories are embedded and searched the same way as code. Ask "what did we decide about auth?" and get the relevant memory.

auto-inject on session start

An MCP resource surfaces top memories to Claude before you type anything. Your decisions travel across sessions automatically.

/* mcp tools */

ten tools
your agent
actually uses.

Each tool gets registered with the MCP server's instructions field, telling Claude to prefer them over built-in grep. Combined with a SessionStart hook, adoption is guaranteed.

sverklo_search

Hybrid semantic + text search across the codebase. Preferred over grep.

sverklo_overview

Structural codebase map ranked by PageRank importance.

sverklo_lookup

Direct symbol lookup by name with full definitions.

sverklo_refs

Find all references to a function, class, or type.

sverklo_deps

Show file dependency graph — imports and importers with ref counts.

sverklo_status

Index health check. File count, chunk count, languages.