Skip to content

feat: support Cursor as a project agent - #83

Merged
nicholasjackson merged 2 commits into
hivecommons:mainfrom
Danathar:feat/81-cursor-support
Oct 26, 2026
Merged

nicholasjackson merged 2 commits into
hivecommons:mainfrom
Danathar:feat/81-cursor-support

Conversation

@Danathar

@Danathar Danathar commented Oct 7, 2026 •

Copy link
Copy Markdown
Contributor

Adds Cursor as a fifth agent: spektacular init cursor.

What it installs

  • Skills go in .cursor/skills/<name>/SKILL.md, using the same eight templates as every other agent. Cursor finds skills in this folder (docs), and each one shows up in Agent chat's / menu, so /spek-new … works. Each skill's frontmatter name matches its folder, which Cursor requires.
  • Standing rules go in root AGENTS.md, the same eight sections codex and omp get. Cursor reads root AGENTS.md itself (docs), so nothing is written to .cursor/rules/ and no CLAUDE.md is created.
  • No command wrappers. Skills already appear as slash commands.
  • Other agents' files and the project's own .cursor/rules/ are left alone.

Migration needs no changes. migrate looks up the recorded agent, so a project with agent: cursor gets its skills reinstalled like any other.

Choice made: .cursor/skills/ instead of .agents/skills/

Cursor reads both folders. I used .cursor/skills/ so that each agent has its own folder, as claude, bob and omp already do. The downside: in a project also set up for codex or claude, Cursor sees a second copy of each skill. The README's new "Using Cursor" section says this and tells users to run init for each agent after upgrading.

Changes

  • internal/agent/cursor.go: the new agent, registered in the agent registry.
  • internal/agent/cursor_test.go: checks the skills (including frontmatter), all eight AGENTS.md sections, and that it writes no wrappers, no rules, no CLAUDE.md and no other agents' folders.
  • Cross-agent tests now include cursor:
    • each AGENTS.md section is written exactly once (5 tests)
    • cursor's installed skills match Claude's byte for byte
    • init installs the epic skills for every agent
    • the error for an unknown agent lists cursor
  • README: added to the agent lists, plus a "Using Cursor" section. agent.go: package doc comment.

Testing

  • go vet ./... passed, gofmt -l is clean, and go test ./... passed.
  • Ran a built binary in a temporary git repo. init cursor wrote 8 .cursor/skills/*/SKILL.md files and an AGENTS.md with all 8 sections, and nothing else outside .spektacular/. Running it again left everything byte-identical. config.yaml recorded agent: cursor, and init --help lists cursor.
  • Overwrote a skill with junk, put back an older config, and ran migrate. It reported "agent": "cursor", "reinstall": true and restored the skill.
  • Not tested: I didn't run it inside Cursor itself (no Cursor install here). The claims about how Cursor finds skills and reads AGENTS.md come from Cursor's docs linked above.

Not done here: the docs site (spektacular-website) is a separate repo and doesn't list Cursor yet.

Closes #81

— hive: backend=omp model=anthropic/claude-opus-5-5 effort=high

`spektacular init cursor` installs the workflow skills under
.cursor/skills/, where Cursor discovers them and lists each in its `/`
menu, and writes the standing-rule sections into root AGENTS.md, which
Cursor reads natively in the editor and the CLI. No command wrappers or
.cursor/rules files are written, and no other agent's files are touched.

Hive-Run: hivecommons#81
Hive-Plan: cursor-agent-integration
Hive-Spec: issue-81#cursor-support
Signed-off-by: Danathar <Danathar@users.noreply.github.com>
Main added GitHub Copilot CLI as an agent while this branch added Cursor.
Conflicts in the cross-agent test lists and README are resolved as the
union of both, and the README integration count becomes six.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Danathar <doug.baggett@gmail.com>
@Danathar

Copy link
Copy Markdown
Contributor Author

hive-base-moved: merged main at 39a0059 into this branch (51a4e9e). Main added the GitHub Copilot CLI agent while this branch added Cursor. The conflicts in the cross-agent test lists and in the README were resolved by keeping both agents, and the README now says six integrations. go test ./... passes.


🐝 Hive Agent: contributor | SHA: unknown

@nicholasjackson

Copy link
Copy Markdown
Collaborator

/approve

@kubestellar-prow

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: nicholasjackson

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@nicholasjackson
nicholasjackson merged commit 4b57bdb into hivecommons:main Oct 26, 2026
4 of 5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Cursor support

2 participants