Skip to content

fix(agents): use cursor-agent binary for accurate version probing (P2) - #714

Closed
Drswith wants to merge 2 commits into
mainfrom
claude/ai-agents-status-27567a
Closed

fix(agents): use cursor-agent binary for accurate version probing (P2)#714
Drswith wants to merge 2 commits into
mainfrom
claude/ai-agents-status-27567a

Conversation

@Drswith

@Drswith Drswith commented Sep 6, 2026

Copy link
Copy Markdown
Owner

Summary

Fixes Cursor agent version probing to use the correct binary name, eliminating collisions with the Quantex agent runtime.

The Cursor agent was configured to use "agent" as its binary name and probe version via agent --version. Since both Cursor and Quantex agents install as agent in PATH, the version probe could return the wrong version (Quantex runtime instead of Cursor CLI).

Fix: Update Cursor catalog to use cursor-agent as the primary binary name, matching Cursor's actual installation structure. Maintains backward compatibility via lookupAliases: ["agent", "cursor"].

Linked Artifacts

  • OpenSpec: cursor-agent-version-probe-fix

Validation

  • bun run lint — passed (0 warnings, 0 errors)
  • bun run format:check — passed
  • bun run test — passed (background task completed with exit code 0)
  • Manual: qtx inspect cursor shows correct version (2026.09.02-c22c1a3)
  • Manual: qtx ls shows Cursor with correct installed version
  • Manual: qtx agent still works (backward compat via alias)
  • Manual: qtx cursor now works (new alias)

Note: bun run typecheck has pre-existing type errors in scripts/release/verify-release-as.ts unrelated to this change.

Release Intent

  • Release: patch - bug fix

Release Summary

Fixes Cursor CLI version detection in qtx ls and qtx inspect cursor by using the correct binary name (cursor-agent).

Docs Updated

  • Not needed

Scope Check

  • I did not add a new ad hoc root-level Markdown file.
  • I updated the relevant issue, ADR, spec, runbook, or captured the missing doc work as follow-up.
  • I did not silently expand project scope without recording it explicitly.

Closure Check

  • Working tree was clean after commit.
  • Branch was pushed and this PR is the active delivery artifact.
  • OpenSpec change is active and will be archived after merge.
  • Release is delegated to release automation.

Notes

The fix involves only the agent catalog definition (src/agents/catalog/cursor.json) and its generated representation. No changes to version probe parsing or core logic were needed—the issue was purely a data configuration error.

The Cursor agent catalog incorrectly used "agent" as the binary name,
which collided with the Quantex agent runtime. This caused version
probes to report the wrong version when both were in PATH.

Changes:
- binaryName: "agent" → "cursor-agent"
- versionProbe.command: ["agent", "--version"] → ["cursor-agent", "--version"]
- selfUpdate.command: ["agent", "update"] → ["cursor-agent", "update"]
- Added "cursor" to lookupAliases for natural invocation (via "qtx cursor")
- Maintained backward compat: "qtx agent" still works via alias

Verification:
- qtx inspect cursor: reports correct version 2026.09.02-c22c1a3
- qtx ls: Cursor row shows correct installed version
- qtx agent / qtx cursor: both work
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant