feat(cursor-cli): add Cursor CLI module #309

matifali · 2025-08-08T18:12:45Z

Closes #305

Summary

Add new module registry/coder-labs/modules/cursor-cli to run Cursor Agent CLI directly (no AgentAPI)
Interactive chat by default; supports non-interactive mode (-p) with output-format
Supports model (-m) and force (-f) flags, initial prompt, and CURSOR_API_KEY
Merges MCP settings into ~/.cursor/settings.json
Installs via npm, bootstrapping Node via NVM if missing (mirrors gemini approach)
Adds Terraform-native tests (.tftest.hcl); all pass locally

Test plan

From module dir:
- terraform init -upgrade
- terraform test -verbose
Expect 4 tests passing covering defaults, flag plumbing, and MCP settings injection
Basic smoke run: ensure cursor-agent is on PATH or set install_cursor_cli=true

…CP settings, model/force) - Runs `cursor-agent` directly (no AgentAPI); interactive chat by default - Supports non-interactive prints (-p) with output-format, model (-m), force (-f) - Merges MCP settings into ~/.cursor/settings.json - Installs via npm (uses nvm if needed); terraform tests added

…only - mcp_json -> <folder>/.cursor/mcp.json (optional) - rules_files map -> <folder>/.cursor/rules/* (optional); link rules docs - always -p; default output_format=json; README updates

…itional_settings; simplify non-interactive run

…anup; remove unused options

…and rules files

- Introduced variables for optional pre-install and post-install scripts in the module. - Updated the main script to execute these scripts if provided. - Enhanced tests to validate the embedding of the new scripts.

…and add post-install wait script - Modified main.tf to pass the folder variable to pre-install and post-install scripts. - Added a new post_install_script in README to wait for the repository to be ready before proceeding.

- Removed the `-p` argument and the conditional for `OUTPUT_FORMAT` from the script to streamline execution and avoid unnecessary options.

….sh script - Reintroduced the `-p` argument and the conditional for `OUTPUT_FORMAT` to enhance script functionality and allow for more flexible execution options.

…t arguments - Eliminated the `output_format` variable from main.tf and removed associated logic from start.sh to simplify the script and reduce complexity.

registry/coder/modules/claude-code/main.test.ts

registry/coder-labs/modules/cursor-cli/main.test.ts

registry/coder-labs/modules/cursor-cli/README.md

Co-authored-by: DevCats <[email protected]>

registry/coder-labs/modules/cursor-cli/README.md

registry/coder-labs/modules/cursor-cli/cursor-cli.tftest.hcl

35C4n0r · 2025-08-16T06:07:02Z

@matifali I've added the basic tftest. If we want to test this more thoroughly, we would have to update the agentapi module to output something (if this is something we want, let me know, I'll raise a separate PR to update the agentapi module.)

matifali · 2025-08-18T14:29:02Z

@DevelopmentCats can you review and approve too?

matifali · 2025-08-18T15:48:31Z

@35C4n0r, one of the tests is failing.

35C4n0r · 2025-08-18T16:11:24Z

@matifali, fixed.

registry/coder-labs/modules/cursor-cli/README.md

35C4n0r · 2025-08-18T17:50:52Z

@DevelopmentCats fixed.

DevelopmentCats · 2025-08-18T17:52:59Z

Also it might be worth explaining that this requires an api key from cursor and adding that to the example. This won't work without one correct? @35C4n0r

35C4n0r · 2025-08-18T18:00:48Z

Also it might be worth explaining that this requires an api key from cursor and adding that to the example. This won't work without one correct? @35C4n0r

Agreed, for tasks, we need api_key variable, added that as a note in Readme.md 👍🏻

DevelopmentCats

Thanks for making those last changes!

I tested it to, and its working great @35C4n0r

matifali marked this pull request as draft August 8, 2025 18:17

matifali added 6 commits August 8, 2025 23:48

feat(cursor-cli): add project MCP and rules support; non-interactive …

7483c77

…only - mcp_json -> <folder>/.cursor/mcp.json (optional) - rules_files map -> <folder>/.cursor/rules/* (optional); link rules docs - always -p; default output_format=json; README updates

chore(cursor-cli): remove Bun test; terraform tests only

a3aa1cf

refactor(cursor-cli): drop extra_args, binary_name, base_command, add…

a075139

…itional_settings; simplify non-interactive run

chore: format cursor-cli module and tests

2a65de4

feat(cursor-cli): configure Coder MCP status slug in module; docs cle…

5e3f555

…anup; remove unused options

chore(cursor-cli): move env to coder_env; update scripts

6f46bc9

matifali changed the title ~~feat(cursor-cli): add Cursor Agent CLI module (no AgentAPI, interactive by default)~~ feat(cursor-cli): add Cursor Agent CLI module Aug 8, 2025

matifali changed the title ~~feat(cursor-cli): add Cursor Agent CLI module~~ feat(cursor-cli): add Cursor CLI module Aug 8, 2025

matifali added 9 commits August 9, 2025 01:55

wip

ce902f6

docs(cursor-cli): enhance README with examples for MCP configuration …

df31818

…and rules files

feat(cursor-cli): add pre-install and post-install script support

d8b9b2a

- Introduced variables for optional pre-install and post-install scripts in the module. - Updated the main script to execute these scripts if provided. - Enhanced tests to validate the embedding of the new scripts.

feat(cursor-cli): add ai_prompt variable

079ff1f

feat(cursor-cli): add output for app ID in main.tf

496efad

refactor(cursor-cli): comment out unused arguments in start.sh script

0a87206

- Removed the `-p` argument and the conditional for `OUTPUT_FORMAT` from the script to streamline execution and avoid unnecessary options.

refactor(cursor-cli): restore previously commented arguments in start…

8b6b659

….sh script - Reintroduced the `-p` argument and the conditional for `OUTPUT_FORMAT` to enhance script functionality and allow for more flexible execution options.

refactor(cursor-cli): remove output_format variable and related scrip…

4edcb00

…t arguments - Eliminated the `output_format` variable from main.tf and removed associated logic from start.sh to simplify the script and reduce complexity.

DevelopmentCats reviewed Aug 9, 2025

View reviewed changes

registry/coder/modules/claude-code/main.test.ts Outdated Show resolved Hide resolved

DevelopmentCats reviewed Aug 9, 2025

View reviewed changes

registry/coder-labs/modules/cursor-cli/main.test.ts Outdated Show resolved Hide resolved

DevelopmentCats reviewed Aug 9, 2025

View reviewed changes

registry/coder-labs/modules/cursor-cli/README.md Outdated Show resolved Hide resolved

matifali added 6 commits August 9, 2025 22:53

revert(claude-code): restore main.test.ts to origin/main state

414b5f2

refactor(cursor-cli): remove non-interactive flags from main.test.ts

f525189

refactor

fcd9f3a

fixup!

058cd8e

fixup!

8d3e5d6

wip

be5c394

DevelopmentCats reviewed Aug 12, 2025

View reviewed changes

registry/coder-labs/modules/cursor-cli/README.md Outdated Show resolved Hide resolved

Update registry/coder-labs/modules/cursor-cli/README.md

7391082

Co-authored-by: DevCats <[email protected]>

matifali commented Aug 15, 2025

View reviewed changes

registry/coder-labs/modules/cursor-cli/README.md Show resolved Hide resolved

matifali commented Aug 15, 2025

View reviewed changes

registry/coder-labs/modules/cursor-cli/cursor-cli.tftest.hcl Outdated Show resolved Hide resolved

feat: update test

f1bca89

feat: bun fmt

d673f3a

35C4n0r previously approved these changes Aug 18, 2025

View reviewed changes

feat: bump agentapi version

dfc007d

35C4n0r dismissed their stale review via dfc007d August 18, 2025 14:33

feat: bump agentapi version

037c223

35C4n0r and others added 2 commits August 18, 2025 21:20

Update main.tf

6748088

feat: add agent type

7db6161

35C4n0r self-requested a review August 18, 2025 16:11

35C4n0r previously approved these changes Aug 18, 2025

View reviewed changes

35C4n0r enabled auto-merge (squash) August 18, 2025 17:30

Merge branch 'main' into feat/cursor-cli-from-main

bfe56f3

DevelopmentCats reviewed Aug 18, 2025

View reviewed changes

registry/coder-labs/modules/cursor-cli/README.md Outdated Show resolved Hide resolved

fix: documentation

77709d1

35C4n0r dismissed their stale review via 77709d1 August 18, 2025 17:50

fix: update documentation

71a1f3d

bun fmt

522f095

35C4n0r requested a review from DevelopmentCats August 18, 2025 18:03

DevelopmentCats approved these changes Aug 18, 2025

View reviewed changes

35C4n0r merged commit 32246a9 into main Aug 18, 2025
4 checks passed

35C4n0r deleted the feat/cursor-cli-from-main branch August 18, 2025 18:08

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(cursor-cli): add Cursor CLI module #309

feat(cursor-cli): add Cursor CLI module #309

matifali commented Aug 8, 2025 •

edited by 35C4n0r

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

35C4n0r commented Aug 16, 2025

Uh oh!

matifali commented Aug 18, 2025

Uh oh!

matifali commented Aug 18, 2025

Uh oh!

35C4n0r commented Aug 18, 2025

Uh oh!

Uh oh!

35C4n0r commented Aug 18, 2025

Uh oh!

DevelopmentCats commented Aug 18, 2025

Uh oh!

35C4n0r commented Aug 18, 2025

Uh oh!

DevelopmentCats left a comment

Uh oh!

Uh oh!

Uh oh!

feat(cursor-cli): add Cursor CLI module #309

feat(cursor-cli): add Cursor CLI module #309

Conversation

matifali commented Aug 8, 2025 • edited by 35C4n0r Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Test plan

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

35C4n0r commented Aug 16, 2025

Uh oh!

matifali commented Aug 18, 2025

Uh oh!

matifali commented Aug 18, 2025

Uh oh!

35C4n0r commented Aug 18, 2025

Uh oh!

Uh oh!

35C4n0r commented Aug 18, 2025

Uh oh!

DevelopmentCats commented Aug 18, 2025

Uh oh!

35C4n0r commented Aug 18, 2025

Uh oh!

DevelopmentCats left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

matifali commented Aug 8, 2025 •

edited by 35C4n0r

Loading