feat(agents): add cursor adapter

[yyovil]

Adds the cursor harness, stacked on #119 (agent platform). Adapter package + Constructors() registration + resolver test. Includes its own activity deriver.

🤖 Generated with Claude Code

Stack

1. feat(agents): agent platform — registry, activity hooks, harness allowlist #119
2. feat(agents): add grok adapter #120
3. feat(agents): add droid adapter #121
4. feat(agents): add amp adapter #122
5. feat(agents): add agy adapter #123
6. feat(agents): add crush adapter #124
7. feat(agents): add aider adapter #125
8. feat(agents): add cursor adapter #126 👈 current
9. feat(agents): add qwen adapter #127
10. feat(agents): add copilot adapter #128
11. feat(agents): add goose adapter #129
12. feat(agents): add auggie adapter #130
13. feat(agents): add continue adapter #131
14. feat(agents): add devin adapter #132
15. feat(agents): add cline adapter #133
16. feat(agents): add kimi adapter #134
17. feat(agents): add kiro adapter #135
18. feat(agents): add kilocode adapter #136
19. feat(agents): add vibe adapter #137
20. feat(agents): add pi adapter #138
21. feat(agents): add autohand adapter #139

[greptile-apps]

Greptile Summary

Adds the cursor agent adapter, stacking on the existing agent-platform infrastructure. The adapter follows the established pattern of codex and opencode adapters: a Plugin struct wiring up GetLaunchCommand, GetRestoreCommand, SessionInfo, and hook management (GetAgentHooks / UninstallHooks / AreHooksInstalled), all backed by atomic file writes via the shared hookutil package.

• cursor.go: Resolves the cursor-agent binary (with PATH + well-known locations fallback), builds launch/restore argv with --, --force, and --yolo permission flags, and caches binary resolution behind a mutex.
• hooks.go: Installs/removes five Cursor native-event hooks into .cursor/hooks.json, preserving unmanaged keys and user-defined entries using the raw-JSON round-trip strategy.
• activity.go + dispatch.go: Maps the four AO sub-command names to Active, Idle, and WaitingInput activity states and registers the deriver in the dispatch table.

Confidence Score: 5/5

Safe to merge; the cursor adapter is a well-contained addition that follows the established codex/opencode pattern with no changes to shared infrastructure.

All new code is isolated to the cursor package and its two registration call-sites. The hook management, binary resolution, and argv construction are well-tested and structurally identical to the already-shipped codex adapter. No shared logic was modified.

No files require special attention.

Important Files Changed

Filename	Overview
backend/internal/adapters/agent/cursor/cursor.go	Core adapter: binary resolution, argv construction (with -- sentinel), session info, and mutex-guarded binary caching. Well-structured, mirrors codex pattern.
backend/internal/adapters/agent/cursor/hooks.go	Hook install/uninstall/check using raw-JSON round-trip to preserve unmanaged keys. Now uses shared hookutil.AtomicWriteFile instead of a local copy.
backend/internal/adapters/agent/cursor/activity.go	Simple switch mapping four AO sub-command names to activity states; clean and well-tested.
backend/internal/adapters/agent/cursor/cursor_test.go	Comprehensive table-driven tests covering argv construction, permission modes, restore/session-info edge cases, hook install/uninstall idempotency, and context cancellation.
backend/internal/adapters/agent/activitydispatch/dispatch.go	Adds "cursor": cursor.DeriveActivityState to the Derivers map; one-line, mechanical change.
backend/internal/adapters/agent/registry/registry.go	Adds cursor.New() to Constructors(); one-line, mechanical change.
backend/internal/daemon/wiring_test.go	Adds {domain.HarnessCursor, "cursor"} to the resolver test table; mechanical, expected change.
backend/internal/adapters/agent/cursor/activity_test.go	Covers all four mapped events plus unknown/native-name cases; confirms the beforeShellExecution native name is correctly unmapped.

Sequence Diagram

sequenceDiagram
    participant AO as AO Daemon
    participant P as cursor.Plugin
    participant FS as .cursor/hooks.json
    participant CA as cursor-agent

    AO->>P: GetAgentHooks(cfg)
    P->>FS: readCursorHooks (preserve existing)
    P->>FS: atomicWriteFile (merge AO hook commands)

    AO->>P: GetLaunchCommand(LaunchConfig)
    P->>P: cursorBinary() [resolve + cache]
    P-->>AO: ["cursor-agent", "-p", "--output-format", "stream-json", "--trust", "--", prompt]

    AO->>CA: exec argv
    CA-->>FS: fires sessionStart hook
    CA-->>AO: activity: Active

    CA-->>FS: fires beforeShellExecution hook
    CA-->>AO: activity: WaitingInput

    CA-->>FS: fires stop hook
    CA-->>AO: activity: Idle

    AO->>P: GetRestoreCommand(RestoreConfig)
    P-->>AO: ["cursor-agent", "-p", ..., "--resume", agentSessionID]

    AO->>P: UninstallHooks(workspacePath)
    P->>FS: readCursorHooks
    P->>FS: atomicWriteFile (remove AO commands, keep user hooks)

Loading

_{Reviews (2): Last reviewed commit: "feat(agents): add cursor adapter" | Re-trigger Greptile}

[greptile-apps]

yyovil has reached the 50-review limit for trial accounts. To continue receiving code reviews, upgrade your plan.