What is Yertle?
Yertle is a collaborative visual workspace for designing, documenting, and exploring software systems. It combines a Git-like content-addressing backend with a real-time visual canvas, giving teams the power to model complex architectures with full version history, branching, and merging. Think of it as GitHub for system architecture diagrams — every change is a commit, every branch is a parallel exploration, and every node is a versioned, queryable object.Why an API and docs?
This documentation site is for developers building on top of Yertle. You can:- Script your workspace with the Yertle CLI
- Connect AI agents through the Yertle MCP server
- Build custom integrations using the REST API
Where to go next
Quickstart
Get from zero to your first API call in five minutes.
Core Concepts
Understand orgs, nodes, branches, commits, and the Git-like model.
Authentication
Learn how to authenticate API requests with JWT bearer tokens.
API Reference
Browse every endpoint with request/response schemas and examples.
Open source tools
The Yertle CLI and MCP server are open source on GitHub:- model-context/yertle-cli — Go CLI distributed via Homebrew
- model-context/yertle-mcp — Model Context Protocol server