Add Cursor agent support on new agent interface by squishykid · Pull Request #392 · entireio/cli

squishykid · 2026-02-17T17:05:24Z

Summary

Adds Cursor as a supported agent with full hook lifecycle, transcript storage, and checkpoint integration.

New: Cursor agent package (`agent/cursor/`)

types.go — Cursor-specific types with conversation_id fallback for session IDs
cursor.go — Agent implementation with JSONL transcript storage (ReadSession, WriteSession, ChunkTranscript, ReassembleTranscript)
lifecycle.go — ParseHookEvent mapping 7 Cursor hooks to normalized lifecycle events, plus ReadTranscript
hooks.go — Hook install/uninstall for .cursor/hooks.json with unknown field preservation
hooks_test.go — 11 hook tests (install, idempotent, force, preserve existing/unknown fields, uninstall)
lifecycle_test.go — 15 lifecycle tests covering all hook types, edge cases, and ReadTranscript
cursor_test.go — 30 tests covering identity, session storage (ReadSession/WriteSession round-trips), chunking, DetectPresence, and sanitizePathForCursor

Modified

setup.go — Uses IsPreview() for preview labels, adds removeAgentHooks for Cursor uninstall
hooks_cmd.go — Blank import for cursor package init() registration
transcript/types.go — Documented Role field (Cursor uses role, Claude Code uses type)
transcript/parse.go — Added shared ExtractModifiedFiles utility for agents with tool_use blocks

Design decisions

No TranscriptAnalyzer: Cursor's transcript format does not contain tool_use blocks, so modified file detection relies on git status instead of transcript parsing
No TokenCalculator: Cursor's transcript does not include token usage data
FormatResumeCommand: Returns a human-readable instruction ("Open this project in Cursor...") since Cursor is a GUI IDE with no CLI resume command

Test plan

Unit tests pass (mise run test)
Integration tests pass (mise run test:integration)
Lint clean (mise run lint)
Builds successfully (go build ./cmd/entire/)
Manual: entire enable --agent cursor creates .cursor/hooks.json
Manual: entire disable removes hooks from .cursor/hooks.json
Manual: entire hooks cursor --help shows all hook verbs

🤖 Generated with Claude Code

cursor

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.}

Comment @cursor review or bugbot run to trigger another review on this PR

cmd/entire/cli/hooks_cursor_posttodo.go

Copilot

Pull request overview

Adds Cursor as a first-class agent implementation in the refactored agent/hook architecture, enabling lifecycle event dispatch, hook installation into .cursor/hooks.json, and reuse of the existing JSONL transcript + incremental checkpoint flow.

Changes:

Introduces cmd/entire/cli/agent/cursor/ implementing Cursor agent identity, transcript handling, lifecycle event mapping, and hook management.
Wires Cursor into hook command registration/dispatch (including PostTodo incremental checkpoints) and agent registry constants.
Updates summarization to treat Cursor transcripts as JSONL (shared path with Claude Code).

Reviewed changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
cmd/entire/cli/summarize/summarize.go	Routes Cursor to the JSONL condensed-transcript path.
cmd/entire/cli/setup.go	Adds Cursor to “Preview” messaging and to global hook removal.
cmd/entire/cli/hooks_cursor_posttodo.go	Adds Cursor PostTodo handler delegating to Claude’s incremental checkpoint logic.
cmd/entire/cli/hooks_cmd.go	Ensures Cursor agent package is registered via blank import.
cmd/entire/cli/hook_registry.go	Adds Cursor PostTodo dispatch path alongside Claude’s.
cmd/entire/cli/agent/registry.go	Adds `AgentNameCursor` / `AgentTypeCursor` constants.
cmd/entire/cli/agent/cursor/types.go	Defines Cursor hooks.json structures + hook input raw types with conversation_id fallback.
cmd/entire/cli/agent/cursor/lifecycle.go	Implements `ParseHookEvent` mapping Cursor hooks to normalized lifecycle events + transcript analyzer methods.
cmd/entire/cli/agent/cursor/lifecycle_test.go	Adds unit tests for lifecycle mapping and conversation_id fallback behavior.
cmd/entire/cli/agent/cursor/hooks.go	Implements install/uninstall/detection for `.cursor/hooks.json` with matcher-based tool hooks.
cmd/entire/cli/agent/cursor/hooks_test.go	Adds unit tests for hook install/uninstall/idempotency/preservation behavior.
cmd/entire/cli/agent/cursor/cursor.go	Implements Cursor agent identity, legacy hook parsing, session I/O, transcript chunking, and modified-file extraction.

cmd/entire/cli/agent/cursor/hooks.go

cmd/entire/cli/summarize/summarize.go

cmd/entire/cli/agent/cursor/hooks.go

cmd/entire/cli/agent/cursor/lifecycle.go

Copilot

Pull request overview

Copilot reviewed 13 out of 13 changed files in this pull request and generated 6 comments.

cmd/entire/cli/agent/cursor/hooks.go

cmd/entire/cli/hooks_cursor_posttodo.go

cmd/entire/cli/setup.go

cmd/entire/cli/agent/cursor/lifecycle.go

cmd/entire/cli/agent/cursor/cursor.go

cmd/entire/cli/transcript/types.go

Copilot

Pull request overview

Copilot reviewed 13 out of 13 changed files in this pull request and generated 5 comments.

cmd/entire/cli/agent/cursor/hooks.go

cmd/entire/cli/agent/cursor/lifecycle_test.go

cmd/entire/cli/agent/cursor/cursor.go

cmd/entire/cli/agent/cursor/hooks.go

Copilot

Pull request overview

Copilot reviewed 13 out of 13 changed files in this pull request and generated 4 comments.

cmd/entire/cli/agent/cursor/lifecycle.go

cmd/entire/cli/agent/cursor/types.go

cmd/entire/cli/agent/cursor/cursor.go

cmd/entire/cli/transcript/types.go

Copilot

Pull request overview

Copilot reviewed 13 out of 13 changed files in this pull request and generated 2 comments.

cmd/entire/cli/hook_registry.go

cmd/entire/cli/hooks_cursor_posttodo.go

Copilot

Pull request overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated 4 comments.

cmd/entire/cli/hooks_cmd.go

cmd/entire/cli/agent/cursor/cursor.go

Soph

🚢

- Remove dead code: ParseHookInput, GetHookConfigPath, SupportsHooks (zero callers) - Remove incorrect extractModifiedFiles/FileModificationTools (Cursor transcript lacks tool_use blocks) - Fix FormatResumeCommand: return human-readable instruction instead of invalid CLI command - Document transcript.Line.Role field (Cursor uses "role", Claude Code uses "type") - Add shared transcript.ExtractModifiedFiles utility to transcript package - ReadSession no longer populates ModifiedFiles (relies on git status instead) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> Entire-Checkpoint: cd204de06bd2

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> Entire-Checkpoint: d5891c95e5a4

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> Entire-Checkpoint: 86d61e18931c

Copilot

Pull request overview

Copilot reviewed 12 out of 12 changed files in this pull request and generated 3 comments.

cmd/entire/cli/transcript/types.go

cmd/entire/cli/summarize/summarize.go

The base branch was changed.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Cursor JSONL uses "role" instead of "type" to distinguish user/assistant messages. Normalize role→type during transcript parsing so all downstream consumers (summarize, explain) work uniformly. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> Entire-Checkpoint: fac4ff295b71

Copilot

Pull request overview

Copilot reviewed 15 out of 15 changed files in this pull request and generated 1 comment.

Copilot · 2026-02-20T14:05:17Z

cmd/entire/cli/summarize/summarize_test.go

+func TestBuildCondensedTranscriptFromBytes_CursorRoleBasedJSONL(t *testing.T) {
+	// Cursor transcripts use "role" instead of "type" and wrap user text in <user_query> tags.
+	// The transcript parser normalizes role→type, so condensation should work.
+	cursorJSONL := `{"role":"user","message":{"content":[{"type":"text","text":"<user_query>\nhello\n</user_query>"}]}}
+{"role":"assistant","message":{"content":[{"type":"text","text":"Hi there!"}]}}
+{"role":"user","message":{"content":[{"type":"text","text":"<user_query>\nadd one to a file and commit\n</user_query>"}]}}
+{"role":"assistant","message":{"content":[{"type":"text","text":"Created one.txt with one and committed."}]}}
+`


Cursor user prompts are wrapped in <user_query>...</user_query> (as noted in this test), but the current extraction path (transcript.ExtractUserContent → textutil.StripIDEContextTags) does not strip those tags. This means summarized/condensed user prompts will likely include the wrapper markup, which will leak into intent extraction and summaries. Consider stripping Cursor’s <user_query> wrapper during user-content extraction (either by extending StripIDEContextTags or adding a Cursor-specific cleanup step) and tightening this test to assert the tags are removed (not just that it contains "hello").

Entire-Checkpoint: f15cd73bd481

squishykid · 2026-02-20T17:33:26Z

cmd/entire/cli/agent/cursor/lifecycle.go

-	if raw.ToolResponse.AgentID != "" {
-		event.SubagentID = raw.ToolResponse.AgentID
-	}
+	//  TODO "tool_output": "{\"status\":\"success\",\"agentId\":\"3211cc34-8d8f-42de-9dcf-c19625b17566\",\"durationMs\":7901,\"messageCount\":1,\"toolCallCount\":1}",


need to fix sub-agent extraction

Copilot AI review requested due to automatic review settings February 17, 2026 17:05

Copilot started reviewing on behalf of squishykid February 17, 2026 17:06 View session

cursor bot reviewed Feb 17, 2026

View reviewed changes

cmd/entire/cli/hooks_cursor_posttodo.go Outdated Show resolved Hide resolved

Copilot AI reviewed Feb 17, 2026

View reviewed changes

cmd/entire/cli/agent/cursor/hooks.go Outdated Show resolved Hide resolved

cmd/entire/cli/summarize/summarize.go Show resolved Hide resolved

cmd/entire/cli/agent/cursor/hooks.go Outdated Show resolved Hide resolved

Soph force-pushed the soph/agent-refactor branch from 905aeb4 to 2abcac1 Compare February 17, 2026 19:53

Base automatically changed from soph/agent-refactor to main February 18, 2026 02:16

squishykid self-assigned this Feb 18, 2026

squishykid added enhancement New feature or request agent-support adding support for additional AI agents labels Feb 18, 2026

squishykid commented Feb 18, 2026

View reviewed changes

cmd/entire/cli/agent/cursor/hooks.go Outdated Show resolved Hide resolved

squishykid commented Feb 18, 2026

View reviewed changes

cmd/entire/cli/agent/cursor/lifecycle.go Outdated Show resolved Hide resolved

squishykid force-pushed the robin/cursor-agent branch from dd067cd to c072c01 Compare February 18, 2026 15:55

squishykid requested a review from Copilot February 18, 2026 15:56

Copilot started reviewing on behalf of squishykid February 18, 2026 16:01 View session

Copilot AI reviewed Feb 18, 2026

View reviewed changes

squishykid marked this pull request as ready for review February 18, 2026 16:18

squishykid requested a review from a team as a code owner February 18, 2026 16:18

squishykid requested a review from Copilot February 19, 2026 09:42

Copilot started reviewing on behalf of squishykid February 19, 2026 09:42 View session

Copilot AI reviewed Feb 19, 2026

View reviewed changes

squishykid marked this pull request as draft February 19, 2026 09:55

squishykid requested a review from Copilot February 19, 2026 10:54

Copilot started reviewing on behalf of squishykid February 19, 2026 10:54 View session

Copilot AI reviewed Feb 19, 2026

View reviewed changes

cmd/entire/cli/agent/cursor/lifecycle.go Outdated Show resolved Hide resolved

cmd/entire/cli/agent/cursor/types.go Outdated Show resolved Hide resolved

cmd/entire/cli/agent/cursor/cursor.go Outdated Show resolved Hide resolved

cmd/entire/cli/transcript/types.go Show resolved Hide resolved

squishykid requested a review from Copilot February 19, 2026 11:13

Copilot started reviewing on behalf of squishykid February 19, 2026 11:13 View session

Copilot AI reviewed Feb 19, 2026

View reviewed changes

cmd/entire/cli/hook_registry.go Show resolved Hide resolved

cmd/entire/cli/hooks_cursor_posttodo.go Outdated Show resolved Hide resolved

cursor: initial support

4ae0a70

squishykid force-pushed the robin/cursor-agent branch from 950ba73 to 4ae0a70 Compare February 19, 2026 13:08

entireio deleted a comment from cursor bot Feb 19, 2026

squishykid requested a review from Copilot February 19, 2026 13:13

Copilot started reviewing on behalf of squishykid February 19, 2026 13:13 View session

Copilot AI reviewed Feb 19, 2026

View reviewed changes

cmd/entire/cli/hooks_cmd.go Show resolved Hide resolved

cmd/entire/cli/agent/cursor/cursor.go Show resolved Hide resolved

cmd/entire/cli/agent/cursor/cursor.go Outdated Show resolved Hide resolved

cmd/entire/cli/agent/cursor/cursor.go Show resolved Hide resolved

cursor: use Type field in transcript

5b802c3

squishykid marked this pull request as ready for review February 19, 2026 13:27

Soph previously approved these changes Feb 19, 2026

View reviewed changes

squishykid changed the base branch from main to rwr/streamline-setup February 20, 2026 09:45

squishykid and others added 7 commits February 20, 2026 10:49

Merge branch 'rwr/streamline-setup' into robin/cursor-agent

2270f89

explain: add cursor

b504a25

Merge branch 'rwr/streamline-setup' into robin/cursor-agent

962d3f3

dead code

362e60d

Add Cursor agent session and transcript tests

600d981

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> Entire-Checkpoint: d5891c95e5a4

Move ReadTranscript tests to lifecycle_test.go

b7c2b2a

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> Entire-Checkpoint: 86d61e18931c

squishykid requested a review from Copilot February 20, 2026 13:34

Copilot started reviewing on behalf of squishykid February 20, 2026 13:35 View session

Copilot AI reviewed Feb 20, 2026

View reviewed changes

cmd/entire/cli/transcript/types.go Show resolved Hide resolved

cmd/entire/cli/transcript/types.go Outdated Show resolved Hide resolved

cmd/entire/cli/summarize/summarize.go Show resolved Hide resolved

Base automatically changed from rwr/streamline-setup to main February 20, 2026 13:42

squishykid and others added 3 commits February 20, 2026 14:47

Merge branch 'main' into robin/cursor-agent

cc3ec5d

omit empty 'Role' field

9fbe8bd

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

squishykid requested a review from Copilot February 20, 2026 13:58

Copilot started reviewing on behalf of squishykid February 20, 2026 13:58 View session

Copilot AI reviewed Feb 20, 2026

View reviewed changes

tuning hooks

7062343

Entire-Checkpoint: f15cd73bd481

squishykid commented Feb 20, 2026

View reviewed changes

Comments

Conversation

squishykid commented Feb 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

New: Cursor agent package (agent/cursor/)

Modified

Design decisions

Test plan

Uh oh!

cursor bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Soph left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Feb 20, 2026

squishykid commented Feb 17, 2026 •

edited

Loading

New: Cursor agent package (`agent/cursor/`)