33## Prerequisites
44
55- Cursor
6+ - Cursor CLI (` agent ` )
7+ - Git
68- Node.js available to Cursor
7- - A clone of this repository
89
9- ## macOS and Linux
10+ ## Marketplace registration and global installation
1011
11- Install globally for the current user:
12+ Run these commands from a directory where ` cursor-plugins/ ` does not already
13+ exist.
1214
13- ``` sh
14- ./install.sh --dry-run
15- ./install.sh
16- ```
15+ ### macOS and Linux
1716
18- The no-argument command targets ` ~/.cursor/ ` , not the current repository.
17+ ``` bash
18+ agent plugin marketplace add https://github.com/fusengine/cursor-plugins.git
19+ git clone --depth 1 https://github.com/fusengine/cursor-plugins.git
20+ ./cursor-plugins/install.sh --dry-run
21+ ./cursor-plugins/install.sh
22+ ```
1923
20- Install into one repository only:
24+ ### Windows PowerShell
2125
22- ``` sh
23- ./install.sh --project /absolute/path/to/your-project --dry-run
24- ./install.sh --project /absolute/path/to/your-project
26+ ``` powershell
27+ agent plugin marketplace add https://github.com/fusengine/cursor-plugins.git
28+ git clone --depth 1 https://github.com/fusengine/cursor-plugins.git
29+ .\cursor-plugins\install.ps1 -DryRun
30+ .\cursor-plugins\install.ps1
2531```
2632
27- ## Windows PowerShell
33+ Marketplace registration and bundled installation are distinct. The official
34+ ` agent plugin marketplace add ` command registers ` fusengine-plugins ` ; it does
35+ not install the 24 plugins. The repository's installer performs the global
36+ installation and defaults to ` ~/.cursor/ ` on macOS/Linux or
37+ ` %USERPROFILE%\.cursor\ ` on Windows. The cloned ` cursor-plugins/ ` directory is
38+ the installer source checkout, not a Cursor marketplace cache. Cursor does not
39+ document a stable marketplace checkout path.
2840
29- ``` powershell
30- .\install.ps1 -DryRun
31- .\install.ps1
41+ ## Project scope
42+
43+ Project scope is optional and applies only to the target repository. Run the
44+ commands below from the directory that contains the cloned ` cursor-plugins/ `
45+ checkout.
46+
47+ ### macOS and Linux project install
48+
49+ ``` sh
50+ ./cursor-plugins/install.sh --project /absolute/path/to/your-project --dry-run
51+ ./cursor-plugins/install.sh --project /absolute/path/to/your-project
3252```
3353
34- Use explicit project scope when needed:
54+ ### Windows PowerShell project install
3555
3656``` powershell
37- .\install.ps1 -Project C:\path\to\your-project -DryRun
38- .\install.ps1 -Project C:\path\to\your-project
57+ .\cursor-plugins\ install.ps1 -Project C:\path\to\your-project -DryRun
58+ .\cursor-plugins\ install.ps1 -Project C:\path\to\your-project
3959```
4060
41- PowerShell delegates to the same Node installer as the Bash entry point. The Bash integration
42- test proves the macOS/Linux path. PowerShell parity remains runtime-unverified until executed on
43- Windows.
61+ PowerShell delegates to the same Node installer as the Bash entry point. The
62+ Bash integration test proves the macOS/Linux path. PowerShell parity remains
63+ runtime-unverified until executed on Windows.
4464
45- ## Global layout
65+ ## Global installation layout
4666
4767``` text
4868~/.cursor/
@@ -53,11 +73,12 @@ Windows.
5373 └── receipt.json
5474```
5575
56- Each marketplace plugin is copied as an immediate child of ` plugins/local ` ; the marketplace root
57- is never installed as one plugin. Existing foreign plugin directories are preserved. Reinstall
58- refreshes only intact installer-owned copies and refuses modified or colliding targets.
76+ The bundled installer copies each repository plugin as an immediate child of
77+ ` plugins/local ` ; the marketplace root is never installed as one plugin.
78+ Existing foreign plugin directories are preserved. Reinstall refreshes only
79+ intact installer-owned copies and refuses modified or colliding targets.
5980
60- ## Project layout
81+ ## Project installation layout
6182
6283``` text
6384<project>/.cursor/
@@ -71,28 +92,30 @@ refreshes only intact installer-owned copies and refuses modified or colliding t
7192 └── plugins/<plugin-name>/
7293```
7394
74- Plugin files are copied into the project instead of linked to an external checkout. The project
75- therefore remains self-contained and the loader never depends on an external symlink target.
95+ Plugin files are copied into the project instead of linked to an external
96+ checkout. The project therefore remains self-contained and the loader never
97+ depends on an external symlink target.
7698
77- ## Scope distinction
99+ ## Installer scope distinction
78100
79101` <project>/.cursor/ ` is project scope. It applies only when Cursor opens that repository.
80102
81- ` ~/.cursor/ ` on macOS/Linux and ` %USERPROFILE%\.cursor\ ` on Windows are user-global scope and are
82- the default. ` <project>/.cursor/ ` is selected only by ` --project ` or ` -Project ` . Both modes copy
83- plugin sources; neither depends on an external checkout symlink.
103+ ` ~/.cursor/ ` on macOS/Linux and ` %USERPROFILE%\.cursor\ ` on Windows are
104+ user-global scope and are the default. ` <project>/.cursor/ ` is selected only by
105+ ` --project ` or ` -Project ` . Both modes copy plugin sources; neither depends on an
106+ external checkout symlink.
84107
85108## Verification
86109
87110``` sh
88- bash tests/global-install.test.sh
89- bash tests/project-install.test.sh
90- bash tests/project-loader-containment.test.sh
91- bash tests/project-install-transaction.test.sh
92- bash tests/project-rule-update.test.sh
93- bash tests/project-uninstall-regressions.test.sh
94- ./verify-project.sh /absolute/path/to/your-project
95- ./verify.sh --repository-only
111+ bash cursor-plugins/ tests/global-install.test.sh
112+ bash cursor-plugins/ tests/project-install.test.sh
113+ bash cursor-plugins/ tests/project-loader-containment.test.sh
114+ bash cursor-plugins/ tests/project-install-transaction.test.sh
115+ bash cursor-plugins/ tests/project-rule-update.test.sh
116+ bash cursor-plugins/ tests/project-uninstall-regressions.test.sh
117+ ./cursor-plugins/ verify-project.sh /absolute/path/to/your-project
118+ ./cursor-plugins/ verify.sh --repository-only
96119```
97120
98121All integration tests use temporary projects and fake home directories.
@@ -102,15 +125,16 @@ All integration tests use temporary projects and fake home directories.
102125Remove only intact installer-owned global artifacts:
103126
104127``` sh
105- ./install.sh --uninstall
128+ ./cursor-plugins/ install.sh --uninstall
106129```
107130
108131Remove one project installation:
109132
110133``` sh
111- ./install.sh --project /absolute/path/to/your-project --uninstall
134+ ./cursor-plugins/ install.sh --project /absolute/path/to/your-project --uninstall
112135```
113136
114- Global uninstall preserves foreign or modified plugin directories and rules. Project uninstall
115- removes only its owned ` workspaceOpen ` entry, managed directory, and unchanged rule. Both modes
116- validate ownership and target types before destructive mutation.
137+ Global uninstall preserves foreign or modified plugin directories and rules.
138+ Project uninstall removes only its owned ` workspaceOpen ` entry, managed
139+ directory, and unchanged rule. Both modes validate ownership and target types
140+ before destructive mutation.
0 commit comments