@buildinternet/releases 0.36.0 → 0.38.0

package/README.md

@@ -45,6 +45,23 @@ Downloads the matching platform binary from npm. Respects `RELEASED_INSTALL_DIR`
 
 Every version publishes signed archives for each platform on the [Releases page](https://github.com/buildinternet/releases-cli/releases) — `releases-{darwin-arm64,darwin-x64,linux-arm64,linux-x64}.gz` and `releases-windows-x64.zip`, each with a matching `.sha256` and a top-level `checksums.txt`. Useful for air-gapped installs, version pinning, or platforms where npm and Homebrew aren't an option.
 
+### Shell completion
+
+Once the matching tap formula update rolls out, Homebrew will install bash, zsh, and fish completions automatically. Until then, and for all non-Homebrew install paths, run:
+
+```bash
+releases completion install          # auto-detects $SHELL
+releases completion install zsh      # or pick explicitly
+```
+
+`install` writes to the conventional location (`~/.zsh/completions/_releases`, `~/.local/share/bash-completion/completions/releases`, or `~/.config/fish/completions/releases.fish`) and prints any rc-file lines you may need to add. The bash and fish paths honor `$XDG_DATA_HOME` and `$XDG_CONFIG_HOME` respectively, so the file lands wherever those point if set. Pass `--path <file>` to override the destination. To pipe the script somewhere yourself:
+
+```bash
+releases completion zsh > /path/to/_releases
+```
+
+Set `RELEASES_NO_COMPLETION_HINT=1` to silence the first-run completion hint.
+
 ## Usage
 
 ```bash
@@ -107,13 +124,22 @@ The plugin bundles:
 
 ### Standalone skills (any agent)
 
-The bundled skills are also available as a standalone package. Install them into any Claude Code / Codex / Cursor / OpenCode workspace using the [`skills`](https://github.com/vercel-labs/skills) CLI, which reads the top-level `skills/` directory of this repo:
+The bundled skills are also available as a standalone package. The fastest way to install them is via the CLI:
+
+```bash
+releases skills install                       # detected agent, current project
+releases skills install --global              # user-wide instead of project
+releases skills install --agent cursor        # override detection
+releases skills install releases-mcp          # just the user-facing lookup skill
+```
+
+This is a thin wrapper around the [`skills`](https://github.com/vercel-labs/skills) CLI from the open agent-skills ecosystem (`vercel-labs/skills`), which auto-detects ~50 supported agents (Claude Code, Codex, Cursor, OpenCode, Gemini CLI, Windsurf, GitHub Copilot, …) and writes to the right per-agent skills directory. If you'd rather skip the `releases` CLI entirely, the underlying command is:
 
 ```bash
 npx skills add buildinternet/releases-cli
 ```
 
-Use this when you only want the skill behavior (auto-triggering on release/CLI questions) without also registering the hosted MCP connection, agents, and `/releases` command that the plugin provides.
+Use this path when you only want the skill behavior (auto-triggering on release/CLI questions) without also registering the hosted MCP connection, agents, and `/releases` command that the plugin provides. Skills are symlinked by default, so re-running `releases skills install` (or `npx skills update releases-cli`) refreshes everything atomically.
 
 ## Environment
 
@@ -122,6 +148,7 @@ Nothing is required for reader access. For admin operations (closed beta — see
 - `RELEASED_API_KEY` — Bearer token for write endpoints. Required for any `releases admin …` command that mutates state. Keys are not self-serve right now.
 - `RELEASED_API_URL` — Override the default `https://api.releases.sh` endpoint (useful for staging).
 - `RELEASED_TELEMETRY_DISABLED=1` — Opt out of anonymous usage pings. `DO_NOT_TRACK=1` is also honored.
+- `RELEASES_DISABLE_SKILL_UPDATE_CHECK=1` — Silence the "skills are behind, run `releases skills install`" stderr nag that fires (at most once per 24h) when the GitHub `skills/` tree has moved since your last install.
 
 Copy `.env.example` to `.env` to configure these locally.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildinternet/releases",
-  "version": "0.36.0",
+  "version": "0.38.0",
   "description": "Changelog indexer and registry for AI agents and developers",
   "bin": {
     "releases": "bin/releases"
@@ -13,11 +13,11 @@
     "README.md"
   ],
   "optionalDependencies": {
-    "@buildinternet/releases-darwin-arm64": "0.36.0",
-    "@buildinternet/releases-darwin-x64": "0.36.0",
-    "@buildinternet/releases-linux-x64": "0.36.0",
-    "@buildinternet/releases-linux-arm64": "0.36.0",
-    "@buildinternet/releases-windows-x64": "0.36.0"
+    "@buildinternet/releases-darwin-arm64": "0.38.0",
+    "@buildinternet/releases-darwin-x64": "0.38.0",
+    "@buildinternet/releases-linux-x64": "0.38.0",
+    "@buildinternet/releases-linux-arm64": "0.38.0",
+    "@buildinternet/releases-windows-x64": "0.38.0"
   },
   "keywords": [
     "changelog",