md² documentation
md² is a local, Git-native workspace for coordinating coding agents, features, worktrees, prompts, commits, and automations.
Every card is a Markdown file, every action and log a json file, all in your repository — agents read and write the same files you do.
Know what AI-assisted work costs by agent, action, feature, and release. Stats connects project activity with measured time, tokens, tool calls, account usage, and estimated subscription cost, with filtered CSV export for further analysis.
Getting started
| Page |
What it covers |
| Install |
Windows installer, running from source, which agent CLIs to have |
| Open your first project |
Local folder, GitHub repository, or a remote desktop app |
| Your first card |
Create a card, add an action, run an agent on it |
Tutorials
Step-by-step walkthroughs of one workflow each. They link to the reference pages for details.
| Tutorial |
What it covers |
| Getting started |
Install, first run, GitHub token, open a project, special folders, md2.config.json |
| Working with cards |
The standard process from idea to release, editor features, actions, conversations, reviewing results |
| Git worktrees |
Set up worktrees, assign them to cards, commit, merge back, resolve merge conflicts with an agent |
| Sequencing and scheduling cards |
Card order, state triggers, chains, schedules, card sequences |
| Working with diagrams |
Render diagrams from code, drill down, create, edit and review, implement diagram changes |
Concepts
| Page |
What it covers |
| Cards and files |
Header fields, file names, card types, ordering |
| Project layout |
Project, working, actions, releases, archive, activity folders |
| Storage modes |
Desktop, remote control, GitHub — and what each can do |
| Actions and agents |
Why actions exist, one-shot versus streaming, where runs happen |
| Usage and cost |
How time, tokens, account usage, and subscription-cost estimates are calculated |
Using md²
| Page |
What it covers |
| Board view |
Columns, cards, drag and drop, policies, card popup |
| List view |
Tree, tabs, editors, conversation panel |
| Diagrams |
Create, explore, edit, review, and save diagrams |
| Stats |
Compare activity, agents, models, tokens, account usage, and estimated cost |
| Search |
Text and RegExp search, scopes, results |
| Git and commits |
Auto-save, commit, push, pull, per-card commit diffs |
| Worktrees |
Register worktrees, assign to cards, commit, integrate, resolve merge conflicts |
| Remote control |
Drive the desktop app from a phone, and its security limits |
| Configuration |
Every setting, and where it is stored |
Actions reference
| Page |
What it covers |
| Action definition |
Every field, appliesTo filters, validation rules |
| Placeholders |
{{card-file}}, {{card-prompt}}, {{card-title}}, {{worktree-folder}}, {{repository-folder}}, {{project-folder}}, {{releases-folder}}, {{actions-folder}}, diagram and conflict placeholders |
| Running actions |
Entry points, popup, conversations, chains, state triggers, scheduling, card sequences |
| Agent setup |
Profiles, models, reasoning levels, conversation logs |
| Cookbook |
Copy-paste action definitions |
Contributing
| Page |
What it covers |
| Development setup |
Repo layout, install, run, test, package |
| Architecture |
Layers, storage services, the renderer-never-executes rule |
| Release process |
Completing a release, release notes, shipping a build |
Help
- Troubleshooting — disabled run buttons, Stats data, Git locks, worktree errors, and remote connections.