set-prompt 0.2.1 → 0.4.0

package/CHANGELOG.md

@@ -4,6 +4,46 @@ All notable changes to this project will be documented in this file.
 
 ---
 
+## [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

package/README.md

@@ -6,13 +6,19 @@ But every time you try a new AI agent, you have to set it all up again from scra
 
 `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.
 
+One repo. Every agent. Always in sync.
+
 ```
-my-prompts/ (git repo)
-    └── skills/, commands/, hooks/
-            ↓ set-prompt install <git-url>
-            ↓ set-prompt link claudecode   →  ~/.set-prompt/claudecode/    (Claude Code plugin)
-            ↓ set-prompt link roocode       →  ~/.roo/                     (symlinks)
-            ↓ set-prompt link openclaw      →  ~/.openclaw/workspace/      (symlinks)
+                        my-prompts/ (git repo)
+                        ├── skills/
+                        ├── commands/
+                        └── hooks/
+                               │
+              ┌────────────────┼─────────────────┬─────────────────┐
+              ▼                ▼                  ▼                 ▼
+    ~/.set-prompt/         ~/.roo/         ~/.openclaw/      ~/.gemini/
+    claudecode/                            workspace/        antigravity/
+    (Claude Code plugin)   (symlinks)      (symlinks)        (symlinks)
 ```
 
 ## 📦 Installation
@@ -25,69 +31,88 @@ npx set-prompt <command>
 
 ## 🚀 Workflow
 
-### 1. Create a prompt repository
+### Step 1 — Install set-prompt
+
+```bash
+npm install -g set-prompt
+```
+
+Or run without installing:
+
+```bash
+npx set-prompt <command>
+```
+
+---
+
+### Step 2 — 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.
+
+```bash
+set-prompt install https://github.com/you/my-prompts
+```
+
+Don't have a repo yet? Scaffold one first:
 
 ```bash
 mkdir my-prompts && cd my-prompts && git init
 set-prompt scaffold .
 ```
 
-Creates:
+This creates the expected directory structure:
 
 ```
 my-prompts/
-├── SET_PROMPT_GUIDE.md
 ├── skills/
-│   └── <skill-name>/
-│       └── SKILL.md
 ├── commands/
-│   └── <command-name>/
-│       └── COMMAND.md
 ├── hooks/
 └── agents/
 ```
 
-### 2. Register the repository
+---
+
+### Step 3 — Link to AI agents 🔗
 
 ```bash
-# remote git URL — cloned to ~/.set-prompt/repo/
-set-prompt install https://github.com/you/my-prompts
+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 antigravity  # link Antigravity only
+set-prompt link cursor       # link Cursor only
 ```
 
-### 3. Link to AI tools 🔗
+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 |
+|---|---|---|
+| Claude Code | `~/.set-prompt/claude-code/` (plugin) | `skills/`, `commands/`, `hooks/`, `agents/` |
+| RooCode | `~/.roo/` | `skills/`, `commands/` |
+| OpenClaw | `~/.openclaw/workspace/` | `skills/` |
+| Antigravity | `~/.gemini/antigravity/` | `skills/` |
+| Cursor | `~/.cursor/` (plugin) | `skills/`, `commands/` |
+
+---
+
+### Step 4 — Uninstall
+
+Removes all set-prompt data, reverts symlinks, and restores any backed-up directories.
 
 ```bash
-set-prompt link              # interactive selection
-set-prompt link claudecode  # Claude Code only
-set-prompt link roocode      # RooCode only
+set-prompt uninstall
 ```
 
-- **Claude Code**: creates a plugin at `~/.set-prompt/claudecode/`, registers via `~/.claude/settings.json`
-- **RooCode**: symlinks `skills/`, `commands/` into `~/.roo/` — backs up existing dirs first
-- **OpenClaw**: symlinks `skills/` into `~/.openclaw/workspace/` — backs up existing dir first
-
 ## 📋 Commands
 
-| Command | Description | Status |
-|---------|-------------|--------|
-| `scaffold [path]` | Verify and scaffold repo structure | ✅ |
-| `install <url>` | Clone remote git repo and register as prompt source | ✅ |
-| `link [agent]` | Link prompts to AI agents (interactive if omitted) | ✅ |
-| `link claudecode` | Link to Claude Code | ✅ |
-| `link roocode` | Link to RooCode | ✅ |
-| `link openclaw` | Link to OpenClaw | ✅ |
-| `link codex` | Link to Codex | 🔜 planned |
-| `link antigravity` | Link to Antigravity | 🔜 planned |
-| `update` | Fetch and pull latest changes from remote repo | ✅ |
-| `status` | Show current repo and linked agents | ✅ |
-| `uninstall` | Remove all set-prompt data | ✅ |
-
-## 🗓️ Planned Integrations
-
-| Agent | Provider | Status |
-|-------|----------|--------|
-| Codex | OpenAI | 🔜 planned |
-| Antigravity | Google | 🔜 planned |
+| Command | Description |
+|---------|-------------|
+| `install <url>` | Clone remote git repo and register as prompt source |
+| `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 |
+| `uninstall` | Remove all set-prompt data and restore backups |
 
 ## ☕ Support
 
@@ -118,9 +143,10 @@ npm test                         # Run tests with vitest
 
 `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`
 - **RooCode** — replaces directories in `~/.roo/`
 - **OpenClaw** — replaces directories in `~/.openclaw/workspace/`
+- **Cursor** — writes to `~/.cursor/`
 
 Before making any changes, `set-prompt` creates a backup and rolls back automatically on failure. However, you should be aware that:
 
@@ -141,14 +167,15 @@ Stored at `~/.set-prompt/config.json`, managed via `ConfigManager`.
 │       ├── skills/
 │       ├── commands/
 │       └── hooks/
-└── claudecode/         # Claude Code plugin output
+└── claude-code/        # Claude Code plugin output
     ├── .claude-plugin/
     │   └── marketplace.json
-    └── plugins/set-prompt/
+    └── plugins/sppt/
         ├── .claude-plugin/plugin.json
         ├── skills/      → symlink to repo/skills/
         ├── commands/    → symlink to repo/commands/
-        └── hooks/       → symlink to repo/hooks/
+        ├── hooks/       → symlink to repo/hooks/
+        └── agents/      → symlink to repo/agents/
 
 ~/.roo/                  # RooCode integration (symlinks)
 ├── SET_PROMPT_BACKUP/  # backup of original dirs before linking
@@ -161,13 +188,18 @@ Stored at `~/.set-prompt/config.json`, managed via `ConfigManager`.
 ├── 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/
 ```
 
 ## 🖥️ Requirements
 
 - **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
+- **Windows only**: symlink creation requires Developer Mode enabled or running as Administrator (Linux/macOS work out of the box)
 
 ## 🤝 Contributing