feat(cursor): multitask slash, auto-review mode, Cursor-native worktree/multi-root

[swear01]

Summary

Close the highest-value Cursor Agent CLI gaps in HAPI remote sessions:

1. /multitask + related slash pass-through (and better subagent task visibility)
2. autoReview permission mode (Cursor Auto-review / Smart Auto)
3. Cursor-native --worktree / --add-dir for Cursor sessions (plus mid-session slash)

Also expand Cursor slash pass-through to commands that are actually useful over ACP (text prompt), not interactive TUI menus.

Research notes (ACP probe on agent 2026.07.09)

• Cursor ACP configOptions.mode only exposes agent | plan | ask (no debug, no auto-review).
• Auto-review is a spawn flag: agent --auto-review acp works; mid-session toggle is slash /auto-review.
• Cursor-native worktree works as agent --worktree <name> acp → ~/.cursor/worktrees/<repo>/<name>.
• Multitask / best-of-n / worktree apply-delete / add-dir are agent slash commands, not ACP config options — remote HAPI should isolate + pass them through as prompts (same pattern as /compress).

Slash pass-through: include vs exclude

Include (agent-executable as prompt; useful remotely):

• already: /compress, /model
• add: /summarize, /compact (aliases)
• add: /multitask, /best-of-n
• add: /worktree, /apply-worktree, /delete-worktree
• add: /add-dir
• add: /context, /fork
• add: /auto-review

Exclude (interactive TUI / IDE-only / needs special protocol):

• /config, /mcp, /sandbox, /plugins, /vim, /copy, /logs, /statusline, /btw, /rewind, /resume, /login, /logout, /update
• Mode switches /ask /plan /debug — already covered by HAPI permission-mode UI via ACP set_config_option

Acceptance criteria

1) Slash pass-through

• Listed include-commands are isolated in the message queue (not newline-batched)
• ACP + legacy remote launchers show a short status line and forward the command text to the agent
• Unit tests cover parsing + isolation

2) Auto-review mode

• autoReview added to CURSOR_PERMISSION_MODES (+ labels/tones + schema allowlist)
• New Cursor ACP sessions with autoReview spawn agent --auto-review … acp
• Mid-session switch to autoReview keeps ACP mode=agent and sends isolated /auto-review once (best-effort; ACP has no config option)
• Web permission picker shows Auto-review for Cursor

3) Cursor-native worktree / multi-root

• For agent=cursor + New Session sessionType=worktree, runner does not create HAPI-side worktree; instead passes Cursor --worktree into ACP spawn
• Optional --add-dir / repeated dirs supported on ACP spawn (CLI flag + runner plumbing); mid-session /add-dir via pass-through
• Session metadata records Cursor worktree path when known (stderr Using worktree: … or resolved path)
• Non-Cursor agents keep existing HAPI createWorktree behavior

4) Subagent visibility (MVP)

• cursor/task notifications render as live CursorTask tool cards with status from payload when present (running/completed), not always force-completed
• Docs note: full Agents Window fleet UI is out of scope; multitask is slash-driven

Out of scope (follow-ups)

• Cloud Agents / /in-cloud / private worker
• Interactive /sandbox /mcp /config remote UIs
• /btw mid-turn overlay, /rewind timeline
• True non-interrupting multitask orchestration UI

Test plan

• bun typecheck && bun run test (shared + cli cursor suites)
• Unit: special-command parser, acp backend arg builder, modes allowlist, runner cursor-worktree branch
• Manual (optional): remote Cursor session — /multitask …, permission Auto-review, New Session worktree for Cursor

[github-actions]

Thanks, this lines up with gaps I can verify in the current codebase. Current Cursor remote sessions already have ACP plumbing, mode/model config, slash-command isolation for a small allowlist, and cursor/task handling, but the requested Cursor-specific features are not implemented yet.

Verified current state:

• Cursor slash pass-through is currently limited to /compress and /model; I did not find /multitask, /best-of-n, /worktree, /add-dir, /auto-review, etc. in the allowlist.
• Special Cursor slash commands are already isolated in the queue when recognized, so the existing mechanism can cover expanded pass-through once the allowlist/status handling is extended.
• Cursor permission modes currently are default, plan, ask, debug, and yolo; autoReview / auto-review is not in the shared mode allowlist, schema, runner args, or web picker source.
• Cursor ACP spawn currently builds agent [--model <model>] acp; I did not find support for --auto-review, --worktree, or --add-dir in that backend constructor.
• New-session worktree currently creates a HAPI-side git worktree before spawning, regardless of agent flavor; I did not find a Cursor-specific branch that delegates worktree creation to Cursor.
• Spawn request plumbing currently carries sessionType and worktreeName, but I did not find an addDir / repeated-dir field through shared API, web client, hub RPC, or runner options.
• cursor/task is registered, but its emitted CursorTask tool call/result is currently forced to completed, not derived from a status payload.

Relevant code:

• shared/src/slashCommands.ts:42 - Cursor built-in slash metadata currently exposes only /compress.
• cli/src/cursor/cursorSpecialCommands.ts:1 - Cursor pass-through parser allowlist is compress, model.
• cli/src/cursor/cursorUserMessageQueue.ts:15 - recognized Cursor special commands are pushed isolated instead of batched.
• shared/src/modes.ts:40 - Cursor permission modes omit autoReview.
• shared/src/modes.ts:43 - global PERMISSION_MODES schema source omits autoReview.
• web/src/components/AssistantChat/HappyComposer.tsx:457 - web permission picker options come from shared flavor modes.
• cli/src/cursor/utils/cursorAcpBackend.ts:19 - Cursor ACP spawn args are built as agent [--model ...] acp.
• cli/src/cursor/utils/cursorModeConfig.ts:13 - Cursor ACP mode mapping maps HAPI modes to ACP agent/plan/ask/debug.
• cli/src/runner/run.ts:338 - runner creates HAPI-side worktrees for all sessionType === 'worktree' sessions.
• shared/src/apiTypes.ts:245 - spawn request schema has sessionType/worktreeName, no multi-root/add-dir field.
• cli/src/modules/common/rpcTypes.ts:3 - runner spawn options have sessionType/worktreeName, no multi-root/add-dir field.
• cli/src/cursor/utils/cursorExtensionAdapter.ts:57 - ACP cursor/task extension handler is registered.
• cli/src/cursor/utils/cursorExtensionAdapter.ts:163 - cursor/task currently emits CursorTask as completed.

No additional info needed from the reporter based on the current issue body.

---

HAPI Bot