Trurlic Documentation
Trurlic is an open-source architecture layer for AI-assisted codebases. It captures human architectural decisions in a typed graph and serves them to every AI coding agent as hard constraints — before a single line is generated.
Think before you build. Then let the machine build what you thought. Named after Trurl from Stanisław Lem’s The Cyberiad — the constructor who reasons deeply about what he creates before creating it. Trurlic brings that discipline to AI-assisted development.
New here?
Section titled “New here?”Start with the 5-minute overview to understand what Trurlic does and why. Then pick your path:
| You want to… | Start here |
|---|---|
| Try Trurlic in 60 seconds | Getting Started |
| Connect an AI coding agent | MCP Server — how the decision graph becomes tools |
| Understand the architecture | Core Concepts → Architecture |
| Bootstrap from an existing codebase | Bootstrap |
| Run a design conversation | Design Conversations |
| Explore the graph visually | Interactive Map |
| Integrate with your IDE agent | Integrations |
Core documentation
Section titled “Core documentation”Getting started
- Overview — what Trurlic is, in 5 minutes
- Getting Started — install, first decision, smoke test
- Core Concepts — decision graph, advance loop, context briefs
Understanding Trurlic
- Architecture — module boundaries, data flow, thread model
- Integrity Model — atomic writes, BLAKE3 hashing, validation invariants
Guides
- MCP Server —
trurlic serveconnects IDE and terminal agents - Configuration — API keys, provider resolution,
config.toml - Design Conversations — Socratic design flow with
trurlic design - Bootstrap — populate the graph from existing source code
- Interactive Map — browser-based graph visualization and editing
- Decision Graph —
.trurlic/format, TOML schema, file layout - Patterns — synthesize patterns from related decisions
- Workflow Engine — advance loop, task types, step sequences
Reference
- CLI Reference — complete command-line reference
- MCP Tools Reference — all twelve MCP tools documented
- Troubleshooting — common issues, diagnostics, solutions
Integrations
Section titled “Integrations”IDE agents: Claude Code · Cursor · Windsurf · Cline · GitHub Copilot · Codex CLI · OpenCode · OpenClaw · Hermes Agent · Antigravity
Other: Custom Agent