One graph. Code, tests & impact. Zero rules.

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.

The extension itself contains no proprietary IP; it is pure glue that calls the public MCP tools exposed at mcp.hokmah.dev. Source: github.com/davidangularme/hokmah-action.