set-prompt 0.5.4 → 0.7.0

package/CHANGELOG.md

@@ -4,6 +4,54 @@ All notable changes to this project will be documented in this file.
 
 ---
 
+## [0.7.0] - 2026-04-20
+
+### Added
+- **OpenCode integration** (`link opencode`) — dir symlinks into `~/.config/opencode/` (OpenCode's default config directory). Links `skills/`, `commands/`, `agents/`.
+- **Gemini CLI integration** (`link geminicli`) — dir symlinks into `~/.gemini/` (coexists with Antigravity's `~/.gemini/antigravity/` subtree). Links `skills/`, `commands/`, `agents/`.
+- `OpencodeConfigSchema` / `GeminicliConfigSchema` + types + `configManager.opencode` / `configManager.geminicli` getter/setter + `isOpencodeEnabled()` / `isGeminicliEnabled()`
+- `SET_PROMPT_GUIDE` template: OpenCode frontmatter reference — skills (`name`, `description`, `license`, `compatibility`, `metadata`), commands (`template` required + `agent`/`model`/`subtask`), agents (`mode`, `temperature`, `top_p`, `steps`, `tools`, `permission`, `prompt` with `{file:...}` reference, etc.)
+- `SET_PROMPT_GUIDE` template: Gemini CLI frontmatter reference — skills (`name` + `description` — minimal), agents (`kind`, `tools` as array, `model`, `temperature` 0–2.0, `max_turns`, `timeout_mins`, `mcpServers` as nested YAML map), and a dedicated TOML sample for Gemini CLI commands (`prompt` required + `description`) with `{{args}}`/`!{cmd}`/`@{path}` placeholders and namespaced subdirectory support (`/git:commit`)
+- Tests: `tests/commands/link-opencode.test.ts`, `tests/commands/link-geminicli.test.ts`
+- README hero rewrite with `One repo. Every AI coding tool. Always in sync.` tagline, npm/GitHub/Sponsor badges, Quick Start section
+- `engines.node >=18` declared in `package.json`
+
+### Changed
+- `link-command.ts`: `LINK_MAP` / `UNLINK_MAP` / `prevLinked` extended with OpenCode and Gemini CLI entries
+- `checkbox` prompt UX: added `loop: false` and `pageSize: ALL_AGENTS.length` so the agent list no longer wraps around and shows all options without scrolling
+- Removed Contributing section from README (not accepting external PRs yet)
+
+### Notes / Caveats
+- **Gemini CLI commands use `.toml`** (not `.md`) — repo's `commands/` needs TOML files for Gemini to recognize them
+- **Gemini CLI agents have strict frontmatter validation** — rejects unknown keys (e.g. `color`, `allowed-tools`, `mode` from other platforms). Allowed keys only: `name`, `description`, `kind`, `tools`, `mcpServers`, `model`, `temperature`, `max_turns`, `timeout_mins`. Warning printed on link completion.
+- **RooCode skill directories must use hyphens, not underscores** — `my_skill` silently fails to register, `my-skill` works. Document-only gotcha (no code change); noted in `SET_PROMPT_GUIDE` skill `name` row.
+
+---
+
+## [0.6.0] - 2026-04-14
+
+### Added
+- `set-prompt repo status` — VCS status: current branch, upstream + ahead/behind, colored list of changed files (separate from `set-prompt status`, which shows linked agents)
+- `set-prompt repo pull` — git fetch + pull (replaces `set-prompt update`)
+- `set-prompt repo commit [-m <msg>]` — stage all + commit locally; auto-generates a subject+body message when `-m` omitted (subject: `update N files`, body: bullet list of repo-relative paths)
+- `set-prompt repo push` — push local commits to remote
+- `set-prompt repo save [-m <msg>]` — one-step macro: commit + push (also auto-generates message)
+- `set-prompt repo path` — prints the installed repo path to stdout (designed for `cd $(sppt repo path)`); errors go to stderr so piping stays clean
+- `set-prompt repo open` — opens the repo in the OS file manager (`explorer` / `open` / `xdg-open`); `--code` opens in VSCode (`code` CLI), `--stree` opens in Sourcetree (auto-detects `SourceTree.exe` at `%LOCALAPPDATA%\SourceTree` on Windows where the `stree` wrapper isn't shipped)
+
+### Changed
+- `scaffold` and `install`: when the resulting working tree is dirty, print a hint guiding the user to run `sppt repo save`. Non-interactive — the user stays in control (earlier design had auto-prompted to run `save`, which risked failing pushes during `install`).
+- `scaffold`: plugin manifests (`.claude-plugin/plugin.json`, `.codex-plugin/plugin.json`) are no longer overwritten when they already exist. Existing files are validated against required fields (`name` for Claude; `name` + `skills` + `mcpServers` + `apps` for Codex — the latter three are pointers Codex uses to load each integration) and preserved as-is — custom values like `version`, `description`, or non-default `name` survive re-runs. Invalid files trigger a warning but stay untouched (status: `+` created / `✓` valid / `⚠` invalid).
+
+### Changed (Breaking)
+- `set-prompt update` removed. Use `set-prompt repo pull` instead.
+- Rationale: VCS-grouped commands read more clearly and leave room for future operations; `pull` is already the cross-VCS norm (Hg/JJ/Fossil all use it). `commit` and `push` stay pure git semantics; `save` is the convenience macro for the common case. `path` / `open` close the "where is my repo?" UX gap since the default install location (`~/.set-prompt/repo/`) felt distant.
+
+### Migration
+- Replace any `set-prompt update` / `sppt update` calls with `set-prompt repo pull` / `sppt repo pull`
+
+---
+
 ## [0.5.4] - 2026-04-13
 
 ### Changed

package/README.md

@@ -1,12 +1,16 @@
 # 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.
+[![npm version](https://img.shields.io/npm/v/set-prompt?color=cb3837&logo=npm)](https://www.npmjs.com/package/set-prompt)
+[![npm downloads](https://img.shields.io/npm/dm/set-prompt?color=informational)](https://www.npmjs.com/package/set-prompt)
+[![GitHub stars](https://img.shields.io/github/stars/juncha9/set-prompt?color=f5d90a&logo=github)](https://github.com/juncha9/set-prompt/stargazers)
+[![last commit](https://img.shields.io/github/last-commit/juncha9/set-prompt?color=blueviolet&logo=github)](https://github.com/juncha9/set-prompt/commits/main)
+[![license](https://img.shields.io/npm/l/set-prompt?color=green)](./LICENSE.md)
+[![node](https://img.shields.io/node/v/set-prompt?color=success&logo=node.js)](https://nodejs.org)
+[![Sponsor](https://img.shields.io/badge/Sponsor-%E2%9D%A4-ea4aaa?logo=github-sponsors)](https://github.com/sponsors/juncha9)
 
-`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 AI coding tool. Always in sync.
 
-One repo. Every agent. Always in sync.
+Your skills, commands, and agents live in git. One command syncs them into every AI coding tool you use — so the prompts you built stay with you no matter which tool you're in.
 
 ```
                     repo/ (git)
@@ -23,26 +27,40 @@ One repo. Every agent. Always in sync.
         ┌──────────────────┼──────────────────────┐
         ▼                  ▼                       ▼
   Claude Code          Codex                  RooCode, OpenClaw,
-  (marketplace +       (marketplace +         Antigravity, Cursor
-   repo symlink)        cache symlink)        (dir symlinks)
+  (marketplace +       (marketplace +         Antigravity, Cursor,
+   repo symlink)        cache symlink)        OpenCode, Gemini CLI
+                                              (dir symlinks)
+```
+
+## Quick Start
+
+From zero to linked in under a minute:
+
+```bash
+npm install -g set-prompt
+sppt install https://github.com/you/my-prompts   # or: sppt scaffold .
+sppt link                                        # interactive checkbox — pick your tools
 ```
 
+That's it. Your prompts are now live in every AI tool you selected.
+
 ## Installation
 
 ```bash
+# global install (recommended)
 npm install -g set-prompt
-# or use without installing
+
+# one-off run without installing
 npx set-prompt <command>
 ```
 
-## CLI Alias
-
-`sppt` is a built-in short alias for `set-prompt` — all commands work with either name:
+Both `set-prompt` and the short alias `sppt` are registered — use whichever you prefer:
 
 ```bash
 sppt install <url>        # connect an existing repo
 sppt link                 # link to AI agents
-sppt update               # pull latest changes
+sppt repo pull            # pull latest changes
+sppt repo save -m "…"     # commit + push local edits
 ```
 
 ## Workflow
@@ -78,6 +96,8 @@ my-prompts/
 └── SET_PROMPT_GUIDE.md          (optional reference doc)
 ```
 
+> **Re-run safety**: `scaffold` never overwrites existing plugin manifests. On re-run, it validates them against required fields and preserves your customizations (custom `name`, `version`, `description`, etc.). Invalid files trigger a warning but stay untouched.
+
 ---
 
 ### Step 2 — Link to AI agents
@@ -90,6 +110,8 @@ 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
+set-prompt link opencode     # link OpenCode only
+set-prompt link geminicli    # link Gemini CLI 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.
@@ -102,22 +124,44 @@ The interactive mode shows all agents with their current state. **Check to link,
 | 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) |
+| OpenCode | dir symlinks into `~/.config/opencode/` | `skills/`, `commands/`, `agents/` |
+| Gemini CLI | dir symlinks into `~/.gemini/` | `skills/`, `commands/`, `agents/` |
 
 > **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 RooCode**: Skill directory names must use hyphens only — `my_skill` (underscore) silently fails to be recognized, while `my-skill` works. Hyphens work on every platform, so default to them.
+
 > **Note on Cursor**: Does not load `rules/` from symlinked directories. Use `.cursor/rules/` within each project instead, or manage rules via Cursor Settings.
 
+> **Note on OpenCode**: Linked at `~/.config/opencode/` — OpenCode's default config directory, so no env var setup required.
+
+> **Note on Gemini CLI**: Skills follow the standard `skills/<name>/SKILL.md` pattern. Commands use `.toml` format (not `.md`) and agents use `.md` with YAML frontmatter. Files in your repo's `commands/` must be TOML for Gemini CLI to recognize them. **Agents have strict frontmatter validation** — unknown keys (e.g. `allowed-tools`, `color`, `mode` from other platforms) cause Gemini CLI to reject the agent. See `SET_PROMPT_GUIDE.md` for the allowed keys.
+
 ---
 
 ### Step 3 — Keep in sync
 
+Primary flow — pull incoming, save outgoing:
+
 ```bash
-set-prompt update    # git pull latest changes from remote
+set-prompt repo pull                  # fetch + pull latest changes from remote
+set-prompt repo save -m "message"     # stage + commit + push in one step
+set-prompt repo save                  # same, but auto-generates message from changed files
 ```
 
-Symlink-based agents (Claude Code, Codex, RooCode, OpenClaw, Antigravity) reflect changes immediately after pull. Cursor's `mcp.json` is a hardlink to repo's `.mcp.json`, so edits to either side are reflected automatically.
+Additional commands:
+
+```bash
+set-prompt repo status                # show branch, ahead/behind, changed files
+set-prompt repo commit -m "message"   # commit locally without pushing
+set-prompt repo push                  # push existing local commits
+set-prompt repo path                  # print repo location (e.g. cd "$(sppt repo path)")
+set-prompt repo open                  # open repo in OS file manager (--code VSCode, --stree Sourcetree)
+```
+
+Symlink-based agents (Claude Code, Codex, RooCode, OpenClaw, Antigravity, OpenCode, Gemini CLI) reflect changes immediately after pull. Cursor's `mcp.json` is a hardlink to repo's `.mcp.json`, so edits to either side are reflected automatically.
 
 ---
 
@@ -135,9 +179,15 @@ set-prompt uninstall
 |---------|-------------|
 | `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 |
+| `repo status` | Show VCS status: branch, ahead/behind, changed files |
+| `repo pull` | Fetch and pull latest changes from remote repo |
+| `repo commit [-m <msg>]` | Stage all changes and commit locally (auto-generates message from changed files if omitted) |
+| `repo push` | Push local commits to remote |
+| `repo save [-m <msg>]` | Stage + commit + push in one step (macro) |
+| `repo path` | Print the repo path to stdout (e.g. `cd $(sppt repo path)`) |
+| `repo open` | Open the repo in the OS file manager (`--code` for VSCode, `--stree` for Sourcetree) |
 | `status` | Show current repo and linked agents |
-| `scaffold [path]` | Create directories and plugin manifests in a prompt repo |
+| `scaffold [path]` | Create or validate directories and plugin manifests (existing files are preserved) |
 | `uninstall` | Remove all set-prompt data and restore backups |
 
 ## What Gets Created
@@ -186,6 +236,19 @@ set-prompt uninstall
 ├── commands/ → repo/commands
 ├── hooks/ → repo/hooks
 └── mcp.json ⇔ repo/.mcp.json  (hardlink)
+
+~/.config/opencode/          # OpenCode (dir symlinks)
+├── SET_PROMPT_BACKUP/
+├── skills/ → repo/skills
+├── commands/ → repo/commands
+└── agents/ → repo/agents
+
+~/.gemini/                   # Gemini CLI (dir symlinks)
+├── SET_PROMPT_BACKUP/
+├── skills/ → repo/skills       (Gemini reads SKILL.md)
+├── commands/ → repo/commands   (Gemini reads *.toml)
+├── agents/ → repo/agents       (Gemini reads *.md)
+└── antigravity/                (Antigravity's own subtree, unrelated)
 ```
 
 ## Warning
@@ -198,6 +261,8 @@ set-prompt uninstall
 - **OpenClaw** — replaces directories in `~/.openclaw/workspace/`
 - **Antigravity** — replaces directories in `~/.gemini/antigravity/`
 - **Cursor** — replaces directories and `mcp.json` in `~/.cursor/`
+- **OpenCode** — replaces directories in `~/.config/opencode/`
+- **Gemini CLI** — replaces directories in `~/.gemini/` (`antigravity/` subtree untouched)
 
 Before making any changes, `set-prompt` creates a backup and rolls back automatically on failure. However, you should be aware that:
 
@@ -219,9 +284,7 @@ Use `set-prompt uninstall` to cleanly revert all changes.
 - 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)
+- [Sponsor on GitHub](https://github.com/sponsors/juncha9) if the project saves you time
 
 ## Dev Commands
 
@@ -233,13 +296,6 @@ npm unlink -g set-prompt         # Remove global CLI
 npm test                         # Run tests with vitest
 ```
 
-## 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 are especially appreciated
-
 ## License
 
 This project is licensed under the [MIT License](./LICENSE.md).