Loading the editor…

Edit the record as text
architecture/main.yaml
The documents written from this record, the folder to take home, and your agent
Deliverables from this record

Written by the engine, not by hand

Every document below was rendered from the record above. Change the record, regenerate, and they change with it. Nothing here was typed twice.

Take it home

Run it with the agent you already use

the record as plain files, as you left it

Supported today: Claude Code, Codex CLI and Cursor in the terminal or your editor, and the Claude Desktop and Codex desktop apps. Needs Node.js 22 or newer. All five run on your own machine and can read and write the record in your repository. Nothing is sent to us.

Through a hosted workspace: claude.ai and ChatGPT in a browser or on a phone, which cannot reach files on your computer. Keep the record on yarramate.dev: A$5 per seat per month, readers free, the first week free.

Once, in a terminalcreates .yarramate/ beside the code
npx yarramate init .
Claude Codein the terminal or your editor
claude mcp add yarramate -- npx -y -p yarramate yarramate-mcp

Or, as a plugin: /plugin marketplace add yarrasys/yarramate then /plugin install yarramate-architecture@yarramate

CodexCLI and the desktop app, same config file
codex mcp add yarramate -- npx -y -p yarramate yarramate-mcp
Cursorin the terminal or your editor, .cursor/mcp.json
{ "mcpServers": { "yarramate": { "command": "npx", "args": ["-y", "-p", "yarramate", "yarramate-mcp"] } } }
Claude DesktopSettings > Developer > Edit Config
{ "mcpServers": { "yarramate": { "command": "npx", "args": ["-y", "-p", "yarramate", "yarramate-mcp"] } } }

Then tell your agent where the record is. Every tool takes a workspace path, and the desktop apps need the full path to .yarramate/workspace.yaml.

The one thing this page cannot show

Checking the record against real code. There is no code in a browser. Once the record lives in your repository, the same tool reports where the code and the record disagree, on every pull request.