Give any AI coding agent persistent codebase understanding. Impact analysis, test generation, code generation — powered by the Hokmah architectural graph.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Hokmah gives any AI coding workflow persistent architectural memory of your codebase.
This extension is a thin client for the hosted Hokmah engine at hokmah.dev — all reasoning happens server-side; nothing leaves your machine except the question you ask.
What this extension does
Five commands, available from the Command Palette under Hokmah:
Command
Tier
Description
Hokmah: Analyze Impact
FREE
Risk score, affected files, related commits for a proposed change. Zero LLM tokens.
Hokmah: Generate Tests
PRO
Generate tests grounded in the architectural graph. ~40× fewer tokens than naive prompting.
Hokmah: Generate Code
PRO
Generate code with architectural memory, reducing hallucination.
Hokmah: Connect Project
FREE
Index a GitHub repository into the Hokmah graph.
Hokmah: Connect External MCP Server
FREE
Plug a third-party MCP server (Jira, Postgres, CI, …) into your Hokmah workspace.
Quick start
Open a folder backed by a GitHub repository.
Run Hokmah: Connect Project (FREE — indexes the repo into the graph).
Run Hokmah: Analyze Impact and describe the change you want to evaluate.
(Optional) For PRO commands, run Hokmah: Set PRO API Key to store your key in VS Code's secret storage.
Results are rendered in a side panel next to your editor.
Configuration
Setting
Default
Description
hokmah.endpoint
https://mcp.hokmah.dev/mcp
MCP server endpoint (Streamable HTTP).
hokmah.defaultBranch
main
Branch used when not derivable from the workspace .git/HEAD.
hokmah.requestTimeoutMs
60000
Tool-call timeout in milliseconds.
hokmah.repoUrlOverride
""
Optional override for the GitHub repo URL (otherwise read from .git/config).
Your PRO API key is stored in VS Code's secret storage (OS keychain). It is never written to settings, telemetry, or logs.
Privacy
The extension is a stateless HTTP client. The only network destination is the value of hokmah.endpoint.
The Hokmah engine never receives the contents of files you have open — only the public GitHub URL and the natural-language query you type into the prompt.
Your PRO API key is sent only on PRO commands (generate_tests, generate_code).
Logs (Output → Hokmah) redact the API key.
Pricing
FREE — Analyze + Connect commands. No API key required.
PRO — Generate Tests + Generate Code. Get a key at hokmah.dev.
How it works
Hokmah builds a TransitionGraph + IdeaGraph + WorldModel from a repository's commit history. Generation queries traverse the graph instead of dumping files into the prompt — that's why PRO commands use ~40× fewer tokens than naive code-agent setups, and why analysis is essentially free.
