A semantic code intelligence layer for humans and AI agents. Your AST, indexed and queryable — so AI agents stop grepping.
📖 English · Français
About · Quickstart · Roadmap · Comparison · FAQ · Support · Changelog
Standardoc transforms your code into a structured, queryable knowledge graph — the AST is the source of truth, kept live by a file watcher, served over MCP and LSP.
AI agents stop guessing. They query.
Code → Language Providers → Canonical IR → SQLite Graph → MCP / LSP → Humans + AI
- AI agents query structure —
find_symbol("createUser")thenget_context(fqdn, depth=1|2). ~100 tokens instead of 30k ofgrep + read. - Cross-language graph — Rust ↔ TypeScript edges (CALLS / IMPORTS / EXTENDS / IMPLEMENTS / …) resolved automatically.
- Live index — file watcher keeps the graph in sync; no rescan dance.
- Local-first — SQLite under
.standardoc/, no SaaS, no telemetry.
Rust toolchain (CLI + MCP + LSP daemon, single binary stdoc) :
cargo install standardoc-cli
stdoc --versionVSCode extension (auto-spawns the daemon, registers MCP for Claude Code in VSCode + Copilot Chat) :
Search "Standardoc" in the VSCode Extensions panel, or grab the latest VSIX from
releases. On first activation
you get an Initialize this workspace? prompt — opt in to write .mcp.json,
generate the AI agent skill, and start the daemon.
See QUICKSTART.md for the full 5-minute walkthrough.
When you initialize a workspace, Standardoc writes
.claude/skills/standardoc/SKILL.md. Claude Code auto-loads it and the AI uses
Standardoc as the first reflex for any code task — find_symbol /
get_context before Read / Grep / Glob.
The skill pre-approves the two MCP tools so they run without per-call permission
prompts. Re-run Standardoc: Regenerate AI agent skill from the VSCode command
palette to refresh after upgrades.
flowchart TD
A[Source code] --> B[Language providers<br/>Rust: syn · TS: swc]
B --> C[Canonical IR]
C --> D[SQLite graph<br/>+ FTS5 index]
D --> E1[LSP daemon<br/>writer, fs lock]
D --> E2[MCP daemon<br/>read-only]
E1 --> F1[VSCode / IDE]
E2 --> F2[Claude Code · Cursor · Continue]
The LSP daemon is the primary writer (acquires the workspace fs lock, runs
the indexer). MCP daemons run --readonly and share the SQLite index
concurrently — no contention.
Beta.1 focuses on Rust + TypeScript with a single binary stdoc, a
file watcher, and 2 honest MCP tools. Documentation rendering (MDX/React),
additional languages, and cross-language bridges land in later milestones.
→ See TODO-LIST.md for the full per-version checkbox roadmap.
- Code is the source of truth
- Structure is derived
- Understanding is a system
Standardoc Core (this repo) — CLI, LSP, MCP, language providers, VSCode extension. FSL-1.1-MIT — converts to plain MIT on April 26, 2028. Free for any non-competing use today, fully MIT after that.
The focus stays on the open-source Core. As long as Standardoc has no cloud/server component that would justify recurring infrastructure, there is no reason to offer a subscription — and none is planned. If a companion tool ever ships (e.g. a GitBook-style local doc UI that runs on your machine, no hosting), it would ship under a one-time lifetime license. Either way, the Core stays OSS and the MIT conversion date above is locked.
If Standardoc helps you rethink how software is understood :
👉 Star the repo · OpenCollective · Other ways
FSL-1.1-MIT — Functional Source License v1.1 with MIT future license. Each release converts to plain MIT on its second anniversary; the first release converts on April 26, 2028.
