Skip to content

Commit e39af7b

Browse files
author
Bruno Azoulay
authored
Merge pull request #1 from fusengine/feat/initial-cursor-marketplace
docs(install): document Cursor marketplace setup
2 parents b1d3487 + 4ba7b57 commit e39af7b

3 files changed

Lines changed: 104 additions & 69 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,4 +2,8 @@
22

33
## [0.0.1] - 01-09-2026
44

5+
- docs(install): document Cursor marketplace setup
6+
7+
## [0.0.1] - 01-09-2026
8+
59
- fix(installer): install Cursor plugins in correct scopes

‎README.md‎

Lines changed: 30 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,44 @@
1-
# Fusengine plugins for Cursor
1+
# Fusengine Cursor Plugins
22

3-
An ecosystem of 24 Cursor plugins for supervised engineering workflows, framework guidance,
4-
security, design, Git, SEO, and code-quality checks.
3+
![version](https://img.shields.io/badge/version-0.0.1-blue?style=flat-square)
4+
![plugins](https://img.shields.io/badge/plugins-24-brightgreen?style=flat-square)
5+
![runtime](https://img.shields.io/badge/runtime-Cursor%20CLI-black?style=flat-square)
6+
![License: MIT](https://img.shields.io/badge/License-MIT-yellow?style=flat-square)
7+
8+
> **Cursor plugin marketplace.** 24 expert plugins for APEX workflows, SOLID/DRY
9+
> enforcement, framework guidance, security, design, Git, SEO, and code quality.
510
611
## Quick install
712

8-
Install for every Cursor workspace owned by the current user:
13+
```bash
14+
# Register the marketplace
15+
agent plugin marketplace add https://github.com/fusengine/cursor-plugins.git
916

10-
```sh
11-
./install.sh --dry-run
12-
./install.sh
17+
# Clone the sources and run the bundled global installer
18+
git clone --depth 1 https://github.com/fusengine/cursor-plugins.git
19+
./cursor-plugins/install.sh --dry-run
20+
./cursor-plugins/install.sh
1321
```
1422

15-
The default scope is `~/.cursor/`: 24 individual plugin roots are copied directly below
16-
`~/.cursor/plugins/local/`, and the global rule is copied to `~/.cursor/rules/fuse-global.mdc`.
17-
18-
To install into only one repository, use the explicit project mode:
23+
Windows PowerShell:
1924

20-
```sh
21-
./install.sh --project /absolute/path/to/your-project
25+
```powershell
26+
agent plugin marketplace add https://github.com/fusengine/cursor-plugins.git
27+
git clone --depth 1 https://github.com/fusengine/cursor-plugins.git
28+
.\cursor-plugins\install.ps1 -DryRun
29+
.\cursor-plugins\install.ps1
2230
```
2331

24-
Reload Cursor after installation. Node.js is required by the installer and plugin hooks.
25-
26-
## How it works
27-
28-
```text
29-
Global: ~/.cursor/plugins/local/<plugin-name> → Cursor loads 24 plugin roots
30-
Project: workspaceOpen → project-local loader → Cursor loads 24 plugin roots
31-
Runtime: plugin hooks → @fusengine/harness
32-
```
32+
These are two distinct steps: `agent plugin marketplace add` registers
33+
`fusengine-plugins`; it does not install the plugins. The bundled installer then
34+
installs them globally for the current user. Its default target is `~/.cursor/`
35+
on macOS/Linux or `%USERPROFILE%\.cursor\` on Windows. The cloned
36+
`cursor-plugins/` directory is the source checkout, not Cursor's marketplace
37+
cache.
3338

34-
The harness runs hook mechanics after plugin discovery; it does not install the plugins.
39+
**Prerequisites:** Cursor CLI, Git, and Node.js available to Cursor. For project
40+
scope, detailed installation, and filesystem layouts, see
41+
[Installation and scope](docs/getting-started/installation.md).
3542

3643
## Documentation
3744

‎docs/getting-started/installation.md‎

Lines changed: 70 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -3,46 +3,66 @@
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

98121
All integration tests use temporary projects and fake home directories.
@@ -102,15 +125,16 @@ All integration tests use temporary projects and fake home directories.
102125
Remove only intact installer-owned global artifacts:
103126

104127
```sh
105-
./install.sh --uninstall
128+
./cursor-plugins/install.sh --uninstall
106129
```
107130

108131
Remove 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

Comments
 (0)