v2.0 for macOS · plain Markdown in, plain Markdown out

Every agent needs a Q.

Meet the harness for your harnesses.

Your agents run the work. Q runs the operation: every project, every agent, every “wait, where was I?”, in the Markdown you already have.

Download for Mac See it work
works with Claude Code Codex Cursor VS Code BBEdit Jupyter + whatever ships next week
my-project docs/hq.md ·

Click a card. Flip to Markdown. Same file, three views.

1 folder is 1 project. That's the whole setup.
73 s for Q to learn how a real orchestrated project runs
2,075 real Markdown files read and re-written with zero bytes changed
0 servers or accounts on our side. Learn runs on your own Claude.
```learn

Q learns how your project already runs.

Point it at a folder. Q lists the files, you untick anything private, and about a minute later you get a map: which file is the status, which is the plan, who hands work to whom, and what's missing. It changes nothing.

Learn Project System · ao-project 73 s · 13 files read · 0 files changed
Files by role
instructionsMANIFEST.md, AO-WORKFLOW.md statusSTATUS.md planROADMAP.md decisionsDECISIONS.md logthe work log
How work moves
Lead ↓ hands off a slice Builder ↓ completion packet ReviewerPASS · REVISE · HOLD
Gaps found: 8
Review verdicts leave no trace in the repo. Nothing says where a blocked handoff gets recorded. + 6 more
Don't take it personally. Everyone has gaps.
Save the map as a template and reuse it on your next project.

Tested on a real Lead → Builder → Reviewer project: Q mapped the flow, the roles and the gaps on its first run. Learn runs on your own Claude Code or API key, sees only the files you ticked, and gets no tools.

```vibe

Stop learning project management systems. Let one learn you.

A folder is a project. No workspace to set up, nothing to import. Q works with your system, even if your system is a TODO.md and vibes. When you change how you work, it changes with you.

01SHIPPED

Learn

Maps how each project runs in about a minute: the roles, the flow, the gaps. Read-only, always.

02COMING SOON™

Improve

Concrete upgrades you approve one at a time, built in a separate git worktree so your working copy never moves under your agents.

03COMING SOON™

Manage

Spots drift, like a STATUS.md that hasn't moved while 12 commits landed. Still practicing its disapproving look.

```hq

Agents in the field. Q at HQ.

Agents post status, claim work and ask questions in one Markdown file. When one needs a human, you get one tap on the shoulder, not twelve tabs.

01
Add the HQQ writes docs/hq.md and tells visiting agents how to use it. It previews every file first and never overwrites anything.
02
Connect your agents onceInstall Q's MCP server for Claude Code and Codex once per Mac. Nothing gets written into your projects.
03
Answer when askedask_human sends you a notification and waits. Reply right from it.
Q now
Needs you · my-project Builder's stuck on the auth migration and would like a word.
docs/hq.md
```status #run
state: awaiting-human
- builder-2: auth migration blocked on token TTL. **need a call**
```

Agents get safe HQ tools: post, claim, ask. Your quick notes and Q's settings stay out of reach.

```layers

Your tools will change. Your system shouldn't.

Every agent tool has its own way of doing things. Next month it'll have a different one. Q sits one layer up, in plain Markdown they all read, so switching tools doesn't mean rebuilding your process.

Q doesn't replace any of them. It's the layer that makes them work together and keeps the books.

Qthe operation projects · status · plans · who needs you
Claude Code Codex Cursor next week's tool
~/git/* your folders · plain Markdown · git
```patch-notes

Regular quality-of-life patches for your workday.

If work is a game, this is the patch that fixes the annoying stuff. And the plugin system is open, so the next patch can be yours.

PATCH NOTES · v2.0 6 changes
[QOL]Quick notes that never touch your repo. Sidebar stickies, their own see-through window, keep on top.
[QOL]Edit Markdown as blocks, without seeing a single asterisk. Drag a heading and its whole section comes along.
[QOL]“Where the hell was I?” Home shows what you had open, and a dot on everything that changed since you looked.
[QOL]⌘K jumps to any project, file, HQ or command in a few keystrokes.
[FIX]Fixed: losing your place. Every project reopens to the file you had open last.
[NEW]Build your own. Plugins run sandboxed, one process each, and ask before they get any permission.
```coming-soon™

Sync with just about everything.

Your boss wants you in Jira? Fine. Q will sync the updates and keep your logs, so you can stop updating tickets by hand. (The ™ is ours. We're trademarking the vagueness.)

Shipped
Slack Google Docs VS Code BBEdit Jupyter
Coming Soon™
Jira ClickUp Linear GitHub Issues Asana Notion
or vibe-create your own · paste into Claude CodeQ still asks before a new plugin gets any permission
Build me a Q plugin that syncs this project's ```board with [YOUR TOOL]. Start from the starter plugin in Q's plugins folder and follow its AGENTS.md. Ask me before adding any permission.

What Q isn't.

Not an IDE. Keep VS Code, BBEdit, whatever you love. Q opens your files in them.
Not an agent. Q doesn't write your code. It keeps the books for the things that do.
Not another workspace. No import, no migration. Your folders stay where they are, and the files stay plain Markdown.
Only Markdown Nothing app-specific is ever written into your .md files.
Known by identity Files are tracked by APFS file ID, so renaming never loses your notes.
Your files, your call No Q servers or accounts. Learn sends Claude only the files you tick.
Simple tooling A native Mac app. SwiftPM, system SQLite, no dependencies.

The name's Q.

Q 2.0 for macOS 26. [PRICE AND AVAILABILITY]

Download for Mac Read the story