CIPHER-Local is a VS Code extension that indexes your workspace with Tree-sitter, stores symbols in SQLite, and exposes 7 MCP tools — all running locally. No cloud. No network. Your code never leaves your machine.
ext install cipher.cipher-local[02] INDEXING
CIPHER-Local activates the moment you open a workspace. Tree-sitter parses every source file, extracts symbols, and populates a local SQLite database. On subsequent saves, only changed files are re-indexed.
[03] ARCHITECTURE
CIPHER-Local mirrors the cloud platform's modular architecture, compressed into a single VS Code extension. Each layer has a clear responsibility.
[04] MCP TOOLS
CIPHER-Local exposes its query engine via the Model Context Protocol. Any MCP-compatible AI assistant — GitHub Copilot, Claude, Cursor — can call these tools directly.
list_namespacesList all indexed workspace namespaces. Use this to discover what repos and branches have been indexed.
search_symbolsFind functions, classes, methods, and variables by name pattern. Supports wildcard matching and kind filtering.
resolve_symbolGet full details of a specific symbol by its fully-qualified name — docstring, type signature, line number, reference count.
find_referencesFind every call site and usage of a symbol across the entire workspace. Returns file, line, and code snippet.
semantic_searchNatural language search over code chunks. Uses FTS5 BM25 scoring (vector ANN with ONNX coming in Phase 4).
get_dependenciesList package dependencies extracted from manifest files (package.json, Cargo.toml, go.mod, etc.).
get_file_contextGet all code chunks and symbols for a specific file. Useful for understanding file structure before making changes.
{ "namespace": "my-app:main:HEAD", "pattern": "refreshToken", "kind": "function" }{
"symbols": [
{ "fqn": "auth.service.refreshToken", "kind": "function",
"file_path": "src/auth/token.service.ts", "line": 38,
"type_sig": "(userId: string) => Promise<TokenPair>" },
{ "fqn": "auth.controller.handleRefresh", "kind": "function",
"file_path": "src/controllers/auth.controller.ts", "line": 92,
"type_sig": "(req: Request, res: Response) => void" }
],
"count": 2
}[05] LANGUAGES
Tree-sitter grammars are bundled as WASM binaries — no native compilation, no platform-specific builds. Works identically on Windows, macOS, and Linux.
[06] INSTALLATION
Search "CIPHER-Local" in the VS Code Extensions panel, or run the CLI command below.
code --install-extension cipher.cipher-localOpen any folder or repo in VS Code. CIPHER-Local activates automatically and starts indexing.
Watch the status bar — it shows "ECIP: Indexing..." then switches to "ECIP: Ready" when done. A 50k-line repo takes under 30 seconds.
The MCP server starts automatically. Works with GitHub Copilot Chat, Claude, Cursor, and any MCP-compatible tool.
[07] UPGRADE PATH
CIPHER-Local uses the same namespace architecture as CIPHER Cloud. When your team is ready for cross-repo queries, org-wide RBAC, and SSE streaming — upgrade without migration. Your local index stays as a fast fallback.
Install the extension, open a folder, and start querying your code in under a minute.
Free & open source · Works offline · No telemetry