Cursor

AgentCraft supports Cursor as a third AI coding agent alongside Claude Code and OpenCode.

Setup

If Cursor is installed (~/.cursor/ directory or cursor CLI on PATH), AgentCraft automatically installs hooks in the current repository at .cursor/hooks.json during setup. Existing hook entries are preserved. These hooks report session events (spawn, active, idle, file operations) to AgentCraft in real time.

To install or update Cursor hooks manually:

npx @idosal/agentcraft install

To remove Cursor hooks:

npx @idosal/agentcraft uninstall

Spawning Cursor Heroes

Press Q at the Town Hall to open Spawn Options, then select Cursor. The provider is marked as not installed if the Cursor CLI cannot be detected. Once selected, W quick-spawns with Cursor until you choose another provider.

Model Selection

When you select a Cursor hero, the model dropdown shows a flat list of Cursor-specific model identifiers. AgentCraft first asks cursor agent models, then falls back to parsing CLI help and finally a built-in compatibility list. This keeps the UI aligned with the installed Cursor version instead of documenting a fixed model catalog.

Cursor model identifiers are short names — they differ from Claude Code and OpenCode model strings.

Features

Cursor heroes appear on the map and support core AgentCraft features including:

• Real-time status tracking
• Mission tracking
• Map visualization
• Hero selection and control groups

Notes

• Cursor integration uses Cursor's own model configuration and subscription
• Some advanced features (plan approval, permission handling, Agent Teams) are Claude Code-specific