# release

release automates deployment of all screenpipe components: desktop app, CLI, MCP server. Updates versions across files, triggers GitHub Actions, and verifies that dependencies stay in sync.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · ★ 22500 repo stars
- Author: screenpipe
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/screenpipe/screenpipe/tree/HEAD/.claude/skills/release/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/screenpipe-release

## What it does

The skill manages three independent releases within a single monorepo. Each component has its own version file: Desktop App in `apps/screenpipe-app-tauri/src-tauri/Cargo.toml`, CLI in the root `Cargo.toml` (under `[workspace.package]`), and MCP in `packages/screenpipe-mcp/package.json` plus `server.json`. When you change a version, the skill runs `./scripts/regenerate-locks.sh` to recompute all tracked `Cargo.lock` files—this is mandatory because stale locks break `cargo test --locked` in CI.

Before releasing the app, the skill checks whether `crates/` has changed since the last CLI release. If only the UI changed, that check can pass, but it first verifies the path exists in the repo rather than relying on an outdated location. MCP follows a different pattern: release triggers only on manual `workflow_dispatch` or an `mcp-v*` tag, and npm refuses to republish an already-published version, so the skill validates this before dispatch.

Once the version commit lands on `main`, the skill sends its SHA to GitHub Actions with `needs_testing` and `force_github_runners` flags. The workflow builds, signs, and uploads artifacts, but does not publish: that remains a manual step via the website admin panel. Before dispatch, the skill confirms the remote `main` SHA matches your local commit, and after the build starts, verifies that the running workflow is pinned to exactly the commit you pushed.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add screenpipe/screenpipe --skill release -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/release/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/release/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add screenpipe/screenpipe --skill release -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/release/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add screenpipe/screenpipe --skill release -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/release/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install screenpipe/screenpipe .claude/skills/release
```

2. **Manually: put the files in place**
- File: `.github/skills/release/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add screenpipe/screenpipe --skill release -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/screenpipe/screenpipe --path .claude/skills/release
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/release/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add screenpipe/screenpipe --skill release -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/screenpipe/screenpipe/tree/HEAD/.claude/skills/release/SKILL.md

## When to use it
- synchronize versions across three components and send them to GitHub Actions
- recompute all Cargo.lock files to prevent CI breakage
- determine whether engine code changed since the last CLI release before shipping an app-only build
- verify MCP version is not already published on npm
- dispatch the build with the exact commit SHA and confirm it reaches artifact signing

## Example prompts
- Show current versions for app, CLI, and MCP and tell me which one to change
- Update app version in `apps/screenpipe-app-tauri/src-tauri/Cargo.toml` to 0.4.30, regenerate all Cargo.lock files, and dispatch the release
- Check whether code under `crates/` changed since the last CLI release and decide if a build is needed

## Similar
- [release-bump](https://affpapa.org/en/nevibecode/skills/release-bump.md) — skill · ★ 3206 repo stars
- [jackin-release-check](https://affpapa.org/en/nevibecode/skills/jackin-release-check.md) — skill · 469 installs
- [auto-release-manager](https://affpapa.org/en/nevibecode/skills/auto-release-manager.md) — skill · 3 installs
- [re0-release](https://affpapa.org/en/nevibecode/skills/re0-release.md) — skill · 1400 installs
- [release-manager](https://affpapa.org/en/nevibecode/skills/borghei-release-manager.md) — skill · 132 installs
- [monorepo-manager](https://affpapa.org/en/nevibecode/plugins/monorepo-manager.md) — plugin · ★ 2858 repo stars

## Other versions with the same name
- [release · tobi](https://affpapa.org/en/nevibecode/skills/tobi-release.md) — 2200 installs
- [release · yeachan-heo](https://affpapa.org/en/nevibecode/skills/yeachan-heo-release.md) — 904 installs
- [Release · schpet](https://affpapa.org/en/nevibecode/skills/release.md) — 3900 installs
- [release · different-ai](https://affpapa.org/en/nevibecode/skills/different-ai-release.md) — 122 installs
- [release · toss](https://affpapa.org/en/nevibecode/skills/toss-release.md) — 208 installs

From the same set: [screenpipe/screenpipe](https://affpapa.org/en/nevibecode/by/screenpipe/screenpipe.md) — 2 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
