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 |
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 |
| 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 and integrate |
| 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}} |
| Running actions |
Entry points, popup, conversations, chains, state triggers, scheduling |
| 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.