Skip to content

Commit 1ef4695

Browse files
docs(agents): correct mq model — daemon is optional, submit self-drains
mq submit opportunistically drains the queue itself. The daemon is an optional machine-wide helper, not a requirement. Clarify submit --wait means integrated, and document mq land for full remote-landed confirmation. Co-authored-by: Andrew <andrewxhill@gmail.com>
1 parent 2e8d664 commit 1ef4695

1 file changed

Lines changed: 11 additions & 10 deletions

File tree

AGENTS.md

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,9 @@ This repo uses `mainline` (`mq`) to coordinate the protected `main` branch.
88
The repo root checkout is the canonical protected `main`. Keep it clean
99
and boring. All feature work happens in topic worktrees.
1010

11-
A machine-global daemon (`mainlined --all`) runs as a LaunchAgent and
12-
drains all registered repos automatically. Agents only need to submit.
11+
`mq submit` queues durably then opportunistically drains the queue
12+
itself — no daemon required. This repo has `[publish].Mode = 'auto'`,
13+
so integration and publish happen in one shot.
1314

1415
### Rules
1516

@@ -34,22 +35,22 @@ pnpm install
3435
# 2. Do all work in the worktree
3536
# edit, test, commit (repeat as needed)
3637
37-
# 3. Submit — the daemon integrates onto main and pushes to remote
38+
# 3. Submit — mq integrates onto main and auto-publishes to remote
3839
mq submit --check-only --json # dry-run before expensive work
39-
mq submit --wait --timeout 15m --json # submit and block until landed
40+
mq submit --wait --timeout 15m --json # submit, integrate, wait for completion
4041
4142
# 4. Clean up
4243
wtdrop ~/Projects/_wt/recallnet/codecontext/my-feature
4344
```
4445

45-
The daemon handles integration (rebase-then-ff onto `main`) and
46-
auto-publishes (push to remote). The agent's job ends at submit.
47-
48-
For durable tracking by `submission_id` instead of blocking inline:
46+
`mq submit --wait` blocks until integrated. With `[publish].Mode = 'auto'`
47+
the publish fires automatically after integration. If you need to confirm
48+
the full remote-landed outcome, use `mq land` or `mq wait --for landed`:
4949

5050
```
51-
mq submit --json # capture submission_id
52-
mq wait --submission <id> --for landed --json --timeout 30m # wait by id
51+
mq land --json --timeout 30m # submit + integrate + publish, one shot
52+
mq submit --json # or: capture submission_id
53+
mq wait --submission <id> --for landed --json --timeout 30m # then wait for remote landing by id
5354
```
5455

5556
`submission_id` is the stable handle for a queued change, not the

0 commit comments

Comments
 (0)