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: session info, prompt input, pre-compact, subagent start/stop with native Cursor fields (conversation_id, subagent_id, task, etc.)
cursor.go — Agent implementation with JSONL transcript storage (ReadSession, WriteSession, ChunkTranscript, ReassembleTranscript)
lifecycle.go — ParseHookEvent mapping 7 Cursor hooks (session-start, session-end, before-submit-prompt, stop, pre-compact, subagent-start, subagent-stop) 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 — 14 lifecycle tests covering all hook types, edge cases, conversation_id fallback, and ReadTranscript
cursor_test.go — 32 tests covering identity, session storage (ReadSession/WriteSession round-trips), chunking, DetectPresence, and sanitizePathForCursor

Modified

registry.go — Adds AgentNameCursor and AgentTypeCursor constants
explain.go — Includes AgentTypeCursor in JSONL transcript scoping/offset logic
hooks_cmd.go — Blank import for cursor package init() registration
summarize/summarize.go + summarize_test.go — Cursor agent support in summarization
transcript/types.go — Documented Role field (Cursor uses role, Claude Code uses type)
transcript/parse.go + parse_test.go — Added shared ExtractModifiedFiles utility for agents with tool_use blocks

Design decisions

Native Cursor hook format: Uses Cursor's own subagent fields (subagent_id, task, subagent_type, etc.) rather than mapping to Claude Code conventions
7 hooks installed: session-start, session-end, before-submit-prompt, stop, pre-compact, subagent-start, subagent-stop
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

- 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

squishykid · 2026-02-23T11:08:23Z

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

+	HookNameSessionEnd         = "session-end"
+	HookNameBeforeSubmitPrompt = "before-submit-prompt"
+	HookNameStop               = "stop"
+	HookNamePreTool            = "pre-tool"


use subagent hooks, not pre-tool

Entire-Checkpoint: f5946bdba9af

Entire-Checkpoint: 6ad0ff14a0da

# Conflicts: # cmd/entire/cli/explain.go

Cursor transcripts don't include token usage data, so return nil instead of an empty struct. Adds tests covering Cursor nil return, empty data, Claude Code basic parsing, and offset slicing. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> Entire-Checkpoint: a2ac14809312

squishykid · 2026-02-24T13:32:57Z

@cursor review

cursor · 2026-02-24T13:33:03Z

PR Summary

Medium Risk
Adds a new agent and modifies shared transcript parsing and token-usage behavior, which could affect checkpoint scoping/summarization across multiple agents if normalization or agent-type branching is incorrect.

Overview
Adds Cursor as a new supported agent, including session transcript storage (JSONL read/write + chunk/reassemble), repo presence detection via .cursor, and lifecycle hook parsing for Cursor’s 7 hook events (session/turn/subagent/compaction).

Implements Cursor hook install/uninstall for .cursor/hooks.json with idempotency, --force reinstall behavior, and round-trip preservation of unknown fields/hook types. Integrates Cursor into existing checkpoint/explain/summarize flows by treating Cursor as Claude-like JSONL, adding role→type normalization in the transcript parser, and disabling token-usage calculation for Cursor (returns nil).

^{Written by Cursor Bugbot for commit 0597c53. Configure here.}

Copilot

Pull request overview

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

Copilot · 2026-02-24T13:38:59Z

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

+	if raw.Task == "" {
+		return nil, nil //nolint:nilnil // nil event = no lifecycle action
+	}


The parseSubagentStart and parseSubagentStop functions both return nil, nil when raw.Task == "". However, the returned Event still includes the ToolUseID field populated from raw.SubagentID, which would be inconsistent - you're returning an event with a tool use ID but no task. Consider checking if raw.SubagentID is also empty, or remove the task check if subagents can exist without tasks.

Copilot · 2026-02-24T13:38:59Z

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

+		// TODO ToolInput:  raw.Task,
+		Timestamp: time.Now(),
+	}
+	if raw.SubagentID != "" {
+		event.SubagentID = raw.SubagentID
+	}


The condition at lines 156-158 appears redundant. The event.SubagentID field is only set if raw.SubagentID != "", but event.ToolUseID was already unconditionally set to raw.SubagentID at line 152. If raw.SubagentID is empty, both fields end up empty anyway. Either the check should apply to both fields (move the conditional before the Event creation), or the SubagentID assignment should use a different source value (like Claude Code uses raw.ToolResponse.AgentID), or the check can be removed entirely.

Suggested change

// TODO ToolInput: raw.Task,

Timestamp: time.Now(),

}

if raw.SubagentID != "" {

event.SubagentID = raw.SubagentID

}

SubagentID: raw.SubagentID,

// TODO ToolInput: raw.Task,

Timestamp: time.Now(),

}

Copilot · 2026-02-24T13:39:00Z

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

+	sessionStartCmd := cmdPrefix + "session-start"
+	sessionEndCmd := cmdPrefix + "session-end"
+	beforeSubmitPromptCmd := cmdPrefix + "before-submit-prompt"
+	stopCmd := cmdPrefix + HookNameStop
+	preCompactCmd := cmdPrefix + HookNamePreCompact
+	subagentStartCmd := cmdPrefix + HookNameSubagentStart
+	subagentEndCmd := cmdPrefix + HookNameSubagentStop


Inconsistent use of string literals vs constants when building hook commands. Lines 125-127 use hardcoded strings ("session-start", "session-end", "before-submit-prompt") while lines 128-131 use constants (HookNameStop, HookNamePreCompact, etc.). For consistency and maintainability, consider using constants for all hook commands, like cmdPrefix + HookNameSessionStart instead of cmdPrefix + "session-start".

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 and others added 4 commits February 20, 2026 14:11

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

squishykid commented Feb 23, 2026

View reviewed changes

squishykid and others added 7 commits February 23, 2026 15:08

Merge branch 'main' of github.com:entireio/cli into robin/cursor-agent

d95e29f

fix hooks

6e9672c

Entire-Checkpoint: f5946bdba9af

cursor: fix tests

a0c9056

Entire-Checkpoint: 6ad0ff14a0da

Merge branch 'main' of github.com:entireio/cli into robin/cursor-agent

58e4f2e

# Conflicts: # cmd/entire/cli/explain.go

cursor: fix lint

3fc9e46

Merge branch 'main' of github.com:entireio/cli into robin/cursor-agent

41a712e

squishykid requested a review from Copilot February 24, 2026 13:32

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

Copilot AI reviewed Feb 24, 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!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Feb 20, 2026

Choose a reason for hiding this comment

Uh oh!

squishykid Feb 20, 2026

Choose a reason for hiding this comment

Uh oh!

squishykid Feb 23, 2026

Choose a reason for hiding this comment

Uh oh!

squishykid commented Feb 24, 2026

Uh oh!

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

squishykid commented Feb 17, 2026 •

edited

Loading

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

cursor bot commented Feb 24, 2026 •

edited

Loading