set-prompt 0.3.0 → 0.5.2

package/CHANGELOG.md

@@ -1,79 +1,131 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
----
-
-## [0.3.0] - 2026-04-06
-
-### Added
-- Antigravity integration (`link antigravity`) — symlinks `skills/` into `~/.gemini/antigravity/skills/` with backup/restore
-- `unlinkClaudeCode`, `unlinkRooCode`, `unlinkOpenclaw`, `unlinkAntigravity` — unlink functions with force mode
-- `link` command interactive mode now supports **deselection** — unchecking a linked agent triggers unlink + backup restore
-- `uninstall` delegates to `unlinkXxx(true)` instead of inlining rollback logic
-
-### Changed
-- `uninstall` no longer contains rollback logic — all agent cleanup goes through `link-command.ts`
-- `AntigravityConfig` schema updated to include `backup_path` (consistent with RooCode/OpenClaw)
-- `AGENT_PROMPT_DIRS[ANTIGRAVITY]` set to `['skills']` only
-- `scaffold` always overwrites `SET_PROMPT_GUIDE.md` — ensures the latest template on every run
-- `SET_PROMPT_GUIDE.md` template updated: Antigravity frontmatter added, OpenClaw `homepage`/`user-invocable` fields added, `metadata` format corrected
-- `build` script now runs `rimraf dist` before `tsup`
-- README workflow restructured into 4 explicit steps
-
----
-
-## [0.2.1] - 2026-04-02
-
-### Changed
-- Add `repository`, `homepage`, `bugs` fields to `package.json` for npm registry links
-- Update package description to "Sync your prompt library across AI coding tools from a single git repo"
-
----
-
-## [0.2.0] - 2026-04-02
-
-### Added
-- `update` command — `git fetch` + `git pull` on the registered repo
-- `agents/` directory to scaffold structure (optional, Claude Code only)
-- Agents frontmatter section in `SET_PROMPT_GUIDE` template
-- `AGENT_PROMPT_DIRS` map — per-agent directory control (claudecode: all, roocode: skills+commands, openclaw: skills only)
-- OpenClaw integration (`link openclaw`) — symlinks `skills/` into `~/.openclaw/workspace/`
-- Backup/restore for OpenClaw (`SET_PROMPT_BACKUP/`)
-
-### Changed
-- Backup folder renamed from `.set-prompt-backup` → `SET_PROMPT_BACKUP`
-- `SET_PROMPT_GUIDE` template: `set-prompt.yaml` → `set-prompt.toml`, updated structure and usage
-- `vitest` reporter set to `--reporter=verbose`
-- `.npmignore`: added `tests/`, fixed `CLAUDE.md` entry, removed redundant entries
-
-### Fixed
-- `link roocode` no longer symlinks `hooks/` (RooCode does not support it)
-
----
-
-## [0.1.0] - 2026-03
-
-### Added
-- RooCode integration (`link roocode`) — symlinks into `~/.roo/` with backup/restore
-- Codex and Antigravity stubs
-- `status` command
-- `uninstall` command with rollback support for Claude Code and RooCode
-- `vitest` test infrastructure with `memfs`
-- Cross-platform symlink support (Windows junction)
-
-### Changed
-- Config format migrated from TOML to JSON (`~/.set-prompt/config.json`)
-- CLI refactored to `commander` with subcommands
-- Build system migrated to `tsup`
-- `ConfigManager` class introduced for typed config management
-
----
-
-## [0.0.1] - 2026-03
-
-### Added
-- Initial project setup (TypeScript + Commander)
-- `scaffold` command
-- `install` command — clone remote git repo into `~/.set-prompt/repo/`
-- `link claudecode` — Claude Code plugin structure at `~/.set-prompt/claudecode/`
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+---
+
+## [0.5.0] - 2026-04-13
+
+### Added
+- Codex integration (`link codex`) — marketplace registration, cache symlink, `config.toml` activation
+- `scaffold` now generates `.claude-plugin/plugin.json`, `.codex-plugin/plugin.json`, `mcp.json`, `.app.json`
+- `ensureClaudePluginManifest()`, `ensureCodexPluginManifest()`, `ensureMcpJson()`, `ensureAppJson()` — reusable functions for link to ensure repo has required files
+- `SET_PROMPT_GUIDE.md` generation now asks for confirmation before writing
+- Cursor: `mcp.json` hardlink (`~/.cursor/mcp.json ⇔ repo/mcp.json`) with backup/restore
+- Cursor: `hooks/` directory linking added
+- `templates.ts`: Cursor frontmatter (skills, agents, rules, hooks), Cursor hooks (JSON-based `hooks.json`), Codex plugin spec
+- Tests split by agent: `link-claude-code.test.ts`, `link-roocode.test.ts`, `link-openclaw.test.ts`, `link-antigravity.test.ts`, `link-codex.test.ts`, `link-cursor.test.ts`
+
+### Changed
+- **Link architecture**: `scaffold` creates plugin manifests in repo, `link` symlinks repo directly (no intermediate plugin structure)
+- Claude Code: marketplace `plugins/sppt` → repo symlink; `installed_plugins.json` points to repo directly
+- Codex: `~/.agents/plugins/marketplace.json` + `~/.codex/plugins/cache/.../1.0.0` → repo symlink
+- Cursor: reverted from plugin to dir symlinks (`~/.cursor/skills/`, `agents/`, `commands/`, `hooks/`)
+- `CODEX_DIR` changed from `~/.codex` to `~/.set-prompt/codex` (no longer deletes Codex home directory on unlink)
+- `scaffold`: removed `--force` option and `valid` check — always runs all steps idempotently
+- All symlinks use `junction` on Windows (consistent across agents)
+- All JSON output uses 4-space indentation
+- `CURSOR_PLUGIN_DIR` removed from `_defs` (Cursor no longer uses plugin approach)
+- `link/` source files moved from `src/commands/link/` to `src/link/`
+- Uninstall tests: removed redundant per-agent unlink call assertions
+
+### Removed
+- `ensureCursorPluginManifest()` — Cursor no longer uses plugin manifests
+- Cursor `rules/` from `AGENT_PROMPT_DIRS` — Cursor does not load rules from symlinked directories
+
+---
+
+## [0.4.0] - 2026-04-10
+
+### Added
+- Cursor integration (`link cursor`) — creates plugin structure at `~/.cursor/` with backup/restore
+- `linkCommand` now shows a Link / Unlink summary before executing; exits early when there are no changes
+- All `unlink*` functions print a colored header banner on start (consistent with `link*`)
+- Console output: `removed` → red, `restored` → green, `backed up` → yellow
+- Console output: `Config loaded` is now green (consistent with `Config saved`)
+
+### Changed
+- Claude Code plugin: `~/.claude/plugins/installed_plugins.json` is now directly patched so `installPath` points to the source plugin directory — bypasses Claude Code's cache management that was deleting the symlink on startup
+- `install`: re-installing the same URL is blocked with a `set-prompt update` hint
+- `install`: re-installing a different URL shows a "Switching repo" warning with confirmation (default: No)
+- `install`: EPERM on directory rename is handled gracefully with a descriptive error message
+- `install`: existing repo backup is automatically removed after a successful clone
+
+### Disabled
+- `link codex` is temporarily unavailable in this release (implementation preserved, re-enable in next release)
+
+---
+
+## [0.3.0] - 2026-04-06
+
+### Added
+- Antigravity integration (`link antigravity`) — symlinks `skills/` into `~/.gemini/antigravity/skills/` with backup/restore
+- `unlinkClaudeCode`, `unlinkRooCode`, `unlinkOpenclaw`, `unlinkAntigravity` — unlink functions with force mode
+- `link` command interactive mode now supports **deselection** — unchecking a linked agent triggers unlink + backup restore
+- `uninstall` delegates to `unlinkXxx(true)` instead of inlining rollback logic
+
+### Changed
+- `uninstall` no longer contains rollback logic — all agent cleanup goes through `link-command.ts`
+- `AntigravityConfig` schema updated to include `backup_path` (consistent with RooCode/OpenClaw)
+- `AGENT_PROMPT_DIRS[ANTIGRAVITY]` set to `['skills']` only
+- `scaffold` always overwrites `SET_PROMPT_GUIDE.md` — ensures the latest template on every run
+- `SET_PROMPT_GUIDE.md` template updated: Antigravity frontmatter added, OpenClaw `homepage`/`user-invocable` fields added, `metadata` format corrected
+- `build` script now runs `rimraf dist` before `tsup`
+- README workflow restructured into 4 explicit steps
+
+---
+
+## [0.2.1] - 2026-04-02
+
+### Changed
+- Add `repository`, `homepage`, `bugs` fields to `package.json` for npm registry links
+- Update package description to "Sync your prompt library across AI coding tools from a single git repo"
+
+---
+
+## [0.2.0] - 2026-04-02
+
+### Added
+- `update` command — `git fetch` + `git pull` on the registered repo
+- `agents/` directory to scaffold structure (optional, Claude Code only)
+- Agents frontmatter section in `SET_PROMPT_GUIDE` template
+- `AGENT_PROMPT_DIRS` map — per-agent directory control (claudecode: all, roocode: skills+commands, openclaw: skills only)
+- OpenClaw integration (`link openclaw`) — symlinks `skills/` into `~/.openclaw/workspace/`
+- Backup/restore for OpenClaw (`SET_PROMPT_BACKUP/`)
+
+### Changed
+- Backup folder renamed from `.set-prompt-backup` → `SET_PROMPT_BACKUP`
+- `SET_PROMPT_GUIDE` template: `set-prompt.yaml` → `set-prompt.toml`, updated structure and usage
+- `vitest` reporter set to `--reporter=verbose`
+- `.npmignore`: added `tests/`, fixed `CLAUDE.md` entry, removed redundant entries
+
+### Fixed
+- `link roocode` no longer symlinks `hooks/` (RooCode does not support it)
+
+---
+
+## [0.1.0] - 2026-03
+
+### Added
+- RooCode integration (`link roocode`) — symlinks into `~/.roo/` with backup/restore
+- Codex and Antigravity stubs
+- `status` command
+- `uninstall` command with rollback support for Claude Code and RooCode
+- `vitest` test infrastructure with `memfs`
+- Cross-platform symlink support (Windows junction)
+
+### Changed
+- Config format migrated from TOML to JSON (`~/.set-prompt/config.json`)
+- CLI refactored to `commander` with subcommands
+- Build system migrated to `tsup`
+- `ConfigManager` class introduced for typed config management
+
+---
+
+## [0.0.1] - 2026-03
+
+### Added
+- Initial project setup (TypeScript + Commander)
+- `scaffold` command
+- `install` command — clone remote git repo into `~/.set-prompt/repo/`
+- `link claudecode` — Claude Code plugin structure at `~/.set-prompt/claudecode/`

package/README.md

@@ -1,27 +1,33 @@
-# Set Prompt 🏠
+# Set Prompt
 
 As you work with AI agents, you build up your own prompt set — skills, commands, and workflows tailored to how you work.
 
 But every time you try a new AI agent, you have to set it all up again from scratch. And as your prompts evolve, keeping them in sync across multiple tools becomes a maintenance burden that the tools themselves don't help with.
 
-`set-prompt` was built to solve this. It maintains a single git repository of prompts and symlinks them into each tool's expected location — so your prompt set stays in one place, stays versioned, and stays consistent across every AI agent you use.
+`set-prompt` was built to solve this. It maintains a single git repository of prompts and links them into each tool's expected location — so your prompt set stays in one place, stays versioned, and stays consistent across every AI agent you use.
 
 One repo. Every agent. Always in sync.
 
 ```
-                        my-prompts/ (git repo)
-                        ├── skills/
-                        ├── commands/
-                        └── hooks/
-                               │
-              ┌────────────────┼─────────────────┬─────────────────┐
-              ▼                ▼                  ▼                 ▼
-    ~/.set-prompt/         ~/.roo/         ~/.openclaw/      ~/.gemini/
-    claudecode/                            workspace/        antigravity/
-    (Claude Code plugin)   (symlinks)      (symlinks)        (symlinks)
+                    repo/ (git)
+                    ├── skills/
+                    ├── commands/
+                    ├── hooks/
+                    ├── agents/
+                    ├── rules/
+                    ├── mcp.json
+                    ├── .app.json
+                    ├── .claude-plugin/plugin.json
+                    └── .codex-plugin/plugin.json
+                           │
+        ┌──────────────────┼──────────────────────┐
+        ▼                  ▼                       ▼
+  Claude Code          Codex                  RooCode, OpenClaw,
+  (marketplace +       (marketplace +         Antigravity, Cursor
+   repo symlink)        cache symlink)        (dir symlinks)
 ```
 
-## 📦 Installation
+## Installation
 
 ```bash
 npm install -g set-prompt
@@ -29,23 +35,19 @@ npm install -g set-prompt
 npx set-prompt <command>
 ```
 
-## 🚀 Workflow
+## CLI Alias
 
-### Step 1 — Install set-prompt
+`sppt` is a built-in short alias for `set-prompt` — all commands work with either name:
 
 ```bash
-npm install -g set-prompt
-```
-
-Or run without installing:
-
-```bash
-npx set-prompt <command>
+sppt install <url>        # connect an existing repo
+sppt link                 # link to AI agents
+sppt update               # pull latest changes
 ```
 
----
+## Workflow
 
-### Step 2 — Connect your prompt repository
+### Step 1 — Connect your prompt repository
 
 Point `set-prompt` at a git repo containing your prompts. It clones it to `~/.set-prompt/repo/` and registers it as your prompt source.
 
@@ -60,36 +62,62 @@ mkdir my-prompts && cd my-prompts && git init
 set-prompt scaffold .
 ```
 
-This creates the expected directory structure:
+This creates the expected directory structure with plugin manifests:
 
 ```
 my-prompts/
 ├── skills/
 ├── commands/
 ├── hooks/
-└── agents/
+├── agents/
+├── rules/
+├── mcp.json
+├── .app.json
+├── .claude-plugin/plugin.json
+├── .codex-plugin/plugin.json
+└── SET_PROMPT_GUIDE.md          (optional reference doc)
 ```
 
 ---
 
-### Step 3 — Link to AI agents 🔗
+### Step 2 — Link to AI agents
 
 ```bash
 set-prompt link              # interactive checkbox — select agents to link
 set-prompt link claudecode   # link Claude Code only
 set-prompt link roocode      # link RooCode only
 set-prompt link openclaw     # link OpenClaw only
+set-prompt link codex        # link Codex only
 set-prompt link antigravity  # link Antigravity only
+set-prompt link cursor       # link Cursor only
 ```
 
 The interactive mode shows all agents with their current state. **Check to link, uncheck to unlink** — existing directories are backed up before being replaced.
 
-| Agent | Where prompts land | What gets linked |
+| Agent | Method | What gets linked |
 |---|---|---|
-| Claude Code | `~/.set-prompt/claudecode/` (plugin) | `skills/`, `commands/`, `hooks/`, `agents/` |
-| RooCode | `~/.roo/` | `skills/`, `commands/` |
-| OpenClaw | `~/.openclaw/workspace/` | `skills/` |
-| Antigravity | `~/.gemini/antigravity/` | `skills/` |
+| Claude Code | marketplace + repo symlink | repo via `~/.set-prompt/claude-code/plugins/sppt` |
+| Codex | marketplace + cache symlink | repo via `~/.agents/plugins/` + `~/.codex/plugins/cache/` |
+| RooCode | dir symlinks into `~/.roo/` | `skills/`, `commands/` |
+| OpenClaw | dir symlinks into `~/.openclaw/workspace/` | `skills/` |
+| Antigravity | dir symlinks into `~/.gemini/antigravity/` | `skills/` |
+| Cursor | dir symlinks into `~/.cursor/` | `skills/`, `agents/`, `commands/`, `hooks/`, `mcp.json` (hardlink) |
+
+> **Note on Claude Code**: Operates as a plugin. Restart Claude Code after linking for the plugin to be recognized.
+
+> **Note on Codex**: Operates as a plugin. Restart Codex after linking — you may need to restart **twice** before the plugin is fully recognized.
+
+> **Note on Cursor**: Does not load `rules/` from symlinked directories. Use `.cursor/rules/` within each project instead, or manage rules via Cursor Settings.
+
+---
+
+### Step 3 — Keep in sync
+
+```bash
+set-prompt update    # git pull latest changes from remote
+```
+
+Symlink-based agents (Claude Code, Codex, RooCode, OpenClaw, Antigravity) reflect changes immediately after pull. Cursor's `mcp.json` is a hardlink, so edits to either side are reflected automatically.
 
 ---
 
@@ -101,7 +129,7 @@ Removes all set-prompt data, reverts symlinks, and restores any backed-up direct
 set-prompt uninstall
 ```
 
-## 📋 Commands
+## Commands
 
 | Command | Description |
 |---------|-------------|
@@ -109,41 +137,67 @@ set-prompt uninstall
 | `link [agent]` | Link/unlink agents interactively, or target one directly |
 | `update` | Fetch and pull latest changes from remote repo |
 | `status` | Show current repo and linked agents |
-| `scaffold [path]` | Verify and create required directories in a prompt repo |
+| `scaffold [path]` | Create directories and plugin manifests in a prompt repo |
 | `uninstall` | Remove all set-prompt data and restore backups |
 
-## ☕ Support
-
-`set-prompt` is a solo side project. I have a full-time job, so there are weeks where I can't touch it — but I read every issue and do my best to respond as quickly as I can. Your support genuinely makes a difference in how much time I can dedicate to this.
+## What Gets Created
 
-**Ways to help:**
-
-- ⭐ **Star this repo** — the simplest thing, and it helps more than you'd think
-- 🐛 **Report bugs** — open an [issue](https://github.com/juncha9/set-prompt/issues) with steps to reproduce
-- 💡 **Request features** — share ideas or use cases via [issues](https://github.com/juncha9/set-prompt/issues)
-- 🔧 **Submit a PR** — new agent integrations (Codex, Antigravity, ...) are especially welcome
-- ☕ **Sponsor** — if `set-prompt` saves you time, buying me a coffee means I can keep working on it
-
-[![Sponsor](https://img.shields.io/badge/Sponsor-%E2%9D%A4-ea4aaa?logo=github-sponsors)](https://github.com/sponsors/juncha9)
-
-## 💻 Dev Commands
-
-```bash
-npx tsx src/index.ts <command>   # Run without building
-npm run build                    # tsup + copy templates
-npm link                         # Register as global CLI (set-prompt)
-npm unlink -g set-prompt         # Remove global CLI
-npm test                         # Run tests with vitest
-.\tests\test-cli.ps1             # Integration tests (PowerShell)
+```
+~/.set-prompt/
+├── config.json
+├── repo/                    # cloned prompt repository
+│   ├── skills/
+│   ├── commands/
+│   ├── hooks/
+│   ├── agents/
+│   ├── rules/
+│   ├── mcp.json
+│   ├── .app.json
+│   ├── .claude-plugin/plugin.json
+│   └── .codex-plugin/plugin.json
+└── claude-code/             # Claude Code marketplace
+    ├── .claude-plugin/marketplace.json
+    └── plugins/sppt → repo  (symlink)
+
+~/.roo/                      # RooCode (dir symlinks)
+├── SET_PROMPT_BACKUP/
+├── skills/ → repo/skills
+└── commands/ → repo/commands
+
+~/.openclaw/workspace/       # OpenClaw (dir symlinks)
+├── SET_PROMPT_BACKUP/
+└── skills/ → repo/skills
+
+~/.gemini/antigravity/       # Antigravity (dir symlinks)
+├── SET_PROMPT_BACKUP/
+└── skills/ → repo/skills
+
+~/.agents/plugins/           # Codex marketplace
+└── marketplace.json
+
+~/.codex/
+├── config.toml              # plugin enabled
+└── plugins/cache/local-repo/sppt/1.0.0 → repo  (symlink)
+
+~/.cursor/                   # Cursor (dir symlinks)
+├── SET_PROMPT_BACKUP/
+├── skills/ → repo/skills
+├── agents/ → repo/agents
+├── commands/ → repo/commands
+├── hooks/ → repo/hooks
+└── mcp.json ⇔ repo/mcp.json  (hardlink)
 ```
 
-## ⚠️ Warning
+## Warning
 
 `set-prompt` modifies configuration files managed by third-party AI agent applications:
 
-- **Claude Code** — writes to `~/.claude/settings.json`
+- **Claude Code** — writes to `~/.claude/settings.json` and `~/.claude/plugins/installed_plugins.json`
+- **Codex** — writes to `~/.agents/plugins/marketplace.json` and `~/.codex/config.toml`
 - **RooCode** — replaces directories in `~/.roo/`
 - **OpenClaw** — replaces directories in `~/.openclaw/workspace/`
+- **Antigravity** — replaces directories in `~/.gemini/antigravity/`
+- **Cursor** — replaces directories and mcp.json in `~/.cursor/`
 
 Before making any changes, `set-prompt` creates a backup and rolls back automatically on failure. However, you should be aware that:
 
@@ -152,59 +206,41 @@ Before making any changes, `set-prompt` creates a backup and rolls back automati
 
 Use `set-prompt uninstall` to cleanly revert all changes.
 
-## 📁 What Gets Created
+## Requirements
 
-Stored at `~/.set-prompt/config.json`, managed via `ConfigManager`.
+- **Node.js** 18+
+- **Git** (must be available in `PATH` for `set-prompt install`)
+- **Windows only**: symlink creation requires Developer Mode enabled or running as Administrator (Linux/macOS work out of the box)
 
-```
-~/.set-prompt/
-├── config.json          # repo_path, remote_url, linked agent state
-├── repo/                # remote repos cloned here
-│   └── <repo-name>/
-│       ├── skills/
-│       ├── commands/
-│       └── hooks/
-└── claudecode/         # Claude Code plugin output
-    ├── .claude-plugin/
-    │   └── marketplace.json
-    └── plugins/set-prompt/
-        ├── .claude-plugin/plugin.json
-        ├── skills/      → symlink to repo/skills/
-        ├── commands/    → symlink to repo/commands/
-        └── hooks/       → symlink to repo/hooks/
-
-~/.roo/                  # RooCode integration (symlinks)
-├── SET_PROMPT_BACKUP/  # backup of original dirs before linking
-│   ├── skills/
-│   └── commands/
-├── skills/              → symlink to repo/skills/
-└── commands/            → symlink to repo/commands/
-
-~/.openclaw/workspace/   # OpenClaw integration (symlinks)
-├── SET_PROMPT_BACKUP/  # backup of original dirs before linking
-│   └── skills/
-└── skills/              → symlink to repo/skills/
-
-~/.gemini/antigravity/   # Antigravity integration (symlinks)
-├── SET_PROMPT_BACKUP/  # backup of original dirs before linking
-│   └── skills/
-└── skills/              → symlink to repo/skills/
-```
+## Support
 
-## 🖥️ Requirements
+`set-prompt` is a solo side project. Your support genuinely makes a difference.
 
-- **Node.js** 18+
-- **Git** (must be available in `PATH` for `set-prompt install`)
-- **Windows**: symlink creation requires either Developer Mode enabled or running as Administrator
+- Star this repo
+- Report bugs — open an [issue](https://github.com/juncha9/set-prompt/issues) with steps to reproduce
+- Request features — share ideas via [issues](https://github.com/juncha9/set-prompt/issues)
+- Submit a PR — new agent integrations are welcome
+
+[![Sponsor](https://img.shields.io/badge/Sponsor-%E2%9D%A4-ea4aaa?logo=github-sponsors)](https://github.com/sponsors/juncha9)
+
+## Dev Commands
+
+```bash
+npx tsx src/index.ts <command>   # Run without building
+npm run build                    # tsup build
+npm link                         # Register as global CLI
+npm unlink -g set-prompt         # Remove global CLI
+npm test                         # Run tests with vitest
+```
 
-## 🤝 Contributing
+## Contributing
 
 > Contribution guidelines are still being figured out. For now, feel free to open an issue to discuss ideas or report bugs.
 
 - Bug reports and feature requests → [GitHub Issues](https://github.com/juncha9/set-prompt/issues)
-- PRs for new agent integrations (OpenClaw, Codex, Antigravity, etc.) are especially appreciated
+- PRs for new agent integrations are especially appreciated
 
-## 📄 License
+## License
 
 This project is licensed under the [MIT License](./LICENSE.md).
-© 2026 [juncha9](https://github.com/juncha9)
+(c) 2026 [juncha9](https://github.com/juncha9)