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.
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 |
Using md²
| Page |
What it covers |
| Board view |
Columns, cards, drag and drop, policies, card popup |
| List view |
Tree, tabs, editors, conversation panel |
| 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, Git locks, tokens, worktree errors, remote connection problems.