Mainark documentation
Mainark turns tickets into reviewed, stacked pull requests using isolated git worktrees and AI agents.
Guides
Parallel agent work
Start here if you run multiple features or epics at once.
- Overview — mental model and when to use what
- Git worktrees — one tree per branch per PR
- Stacked PRs — dependency chains on GitHub
- Linear setup — blockers, plans, what stays in Linear (current SoT; see ADR-001 for exit plan)
- Commands — CLI cheat sheet
- Anti-patterns — what not to add to target repos
Architecture
- ADR-001: Mainark owns the task graph — exit Linear; SQLite local backend opt-in
- TaskProvider boundary — Linear default;
TASK_BACKEND=sqlitefor local store - Backend spike (Phase 2) — Beads design review; SQLite prior stands
Reference
- Local CLI — install, review loop, env vars (developer reference)
Audiences
| You are… | Start with |
|---|---|
| Human operator | Parallel agents overview |
| Cursor / coding agent | Same guide + repo rule .cursor/rules/mainark-parallel.mdc |
| Website visitor | mainark.com/docs (this content, rendered) |