All documentation targets Cursor 3.6.21 (cursor-bin 3.6.21-1, vscodeVersion 1.105.1, commit e7a7e93f4d75f8272503ecf33cedbaae10114a10). Re-audited 2026-05-29; claims carry per-claim last-verified markers — unmarked claims retain their 3.0.16 baseline and were not re-verified at 3.6.21.
Statements in this documentation may be tagged by source type:
- [official-doc] — Published Cursor documentation or product copy.
- [changelog] — Release notes or changelog entries.
- [staff-forum] — Staff or maintainer statements in forums, Discord, or similar channels.
- [repro-local] — Verified locally in this version (reproducible setup).
- [binary-only] — Inferred from shipped binaries or bundles; not guaranteed as a supported or documented API. Not a stable feature.
- [community] — Third-party reports, reverse engineering, or unverified community claims. Not a stable feature.
Items tagged [binary-only] or [community] are exploratory or implementation-detail territory. Do not treat them as contractual product behavior.
Pages are grouped by feature area. Each page explains what the capability is, how oh-my-cursor uses it today, and what related options or surfaces exist beyond that usage.
| # | Page | Topic |
|---|---|---|
| 01 | Modes & Switching | Mode switching matrix (UI, CLI, ACP, SwitchMode tool) |
| 02 | Agent System | Agents, subagents, Task tool, custom agents |
| 03 | Hooks | Hook events, lifecycle, configuration, sharp edges |
| 04 | Rules & AGENTS.md | Rule types, precedence, team rules, remote rules |
| 05 | Skills | Skill system, paths, YAML frontmatter, migration |
| 06 | Commands | Slash commands, /worktree, /best-of-n |
| 07 | MCP | MCP transports, Apps, OAuth, permissions.json |
| 08 | Plan System | Plan files, cursorPlan URI, plan UI integration |
| 09 | CLI | CLI flags, agent acp, print mode, cloud |
| 10 | ACP | Agent Control Protocol methods and schemas |
| 11 | Cloud Agents API | HTTP API endpoints, auth, webhooks |
| 12 | Plugin System | .cursor-plugin manifest, sandbox, directory layout |
| 13 | Agents Window | Agents Window, Design Mode, Agent Tabs, voice |
| 14 | Extension API | Cursor vscode.d.ts additions, API proposals, extensions |
| 15 | Settings & Flags | cursor.* settings, feature flags, Statsig |
| 16 | Binary Analysis | .asar unpacking, internal modules, build flags |
| 17 | Community Discoveries | RPC reverse engineering, proxy techniques (non-normative) |
| 18 | Adoption Matrix | Feature x oh-my-cursor status matrix |
| 19 | Known Sharp Edges | Bugs, gotchas, version-dependent behavior |
oh-my-cursor currently uses: custom agents, hooks (18 of 21 canonical events wired), slash commands, rules (.mdc), skills, MCP sidecar, native tools (AskQuestion, TodoWrite, SwitchMode), plan system, and plugin manifest. See Adoption Matrix for the full breakdown.
- Subagent latency research — separate from this reference; covers orchestration and latency, not Cursor 3.x surface documentation.