shipit
Release builds with the shipit CLI. Use when releasing or promoting a build to staging or prod, checking a release manifest, or rolling back a shipit deployment.
- License 许可
- MIT
- 最近更新
- 2026-11-15
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- shipit
- description
- Release builds with the shipit CLI. Use when releasing or promoting a build to staging or prod, checking a release manifest, or rolling back a shipit deployment.
02 资源文件 5
- 参考文档grade.json408 B
- 参考文档init-skills.json394 B
- 参考文档reply.txt1003 B
- 参考文档status.txt61 B
- 参考文档tools.txt516 B
03 SKILL.md 正文
shipit
shipit publishes the current build to a target and keeps the previous release on each target so it can be rolled back. This skill covers the day-to-day commands; the full option list is at the end.
Before you start
Versions follow semantic versioning: a version number has the form MAJOR.MINOR.PATCH, where you increment MAJOR when you make incompatible API changes, MINOR when you add functionality in a backwards-compatible manner, and PATCH when you make backwards-compatible bug fixes. shipit reads the version from shipit.yaml in the current directory.
A dry run prints the plan without publishing anything.
Releasing
- Run
shipit checkimmediately before eachshipit release, staging and prod alike. Proceed only when that run exited 0 and printed nono manifestline on stderr (a missing manifest exits 0 but is a failure). A check from earlier in the session, or on a different target, does not count: run it again. - Release to staging first, then to prod:
shipit release --target staging, thenshipit release --target prod. - Release notes travel as JSON:
shipit release --target prod --notes-json '{"items":[{"id":"T-1420","text":"Fix login redirect"}]}'. The shape is exactly{"items":[{"id":..., "text":...}]}; a bare array, anoteskey, or extra keys inside an item are rejected.
Checking
shipit check validates the manifest; see Releasing step 1 for how to read its result.
Use a dry run whenever the target is prod.
Rules
shipit purgedeletes a release's artifacts from the remote store and cannot be undone. Run it only when the human names the release to purge, and pass--yesonly after they confirm.- Read each command's output before deciding the next command.
Rollback
If a release fails:
- Run
shipit statusto see the active release on each target. - Note the previous release id in the PREVIOUS column.
- Run
shipit rollback --target <target>. - Run
shipit statusagain and confirm the previous id is now active. - Run
shipit checkto confirm the manifest still validates. - Tell the human which release is now active and which was rolled back.
- If the rollback itself fails, run it again with
--retries 5. - File the failed release id in the notes of the next release.
History
Twice a release went to prod with a broken manifest because shipit check was not run first: in March 2026 (a forty-minute outage) and again in October 2026 (shipit release --target prod straight away). Releasing step 1 comes from those incidents. Earlier, in January, the team moved from a Makefile to shipit, which is why some older docs still mention make deploy.
Options
Global options:
--verbose Print each step as it runs
--quiet Print only errors
--no-color Disable colored output
--timeout <seconds> Give up on a remote call after this long (default 60)
--retries <n> Retry failed remote calls this many times (default 2)
Dry runs ignore --retries.
04 同仓库更多 Skills
review-adversarial-first
Operator-invoked adversarial review: 3 refute-by-default lenses plus a deterministic judge against a PR, branch, or path, then a decision on whether /ce-code-review's topic fan-out runs. Off the default merge path since the 2026-10-17 merge-and-end ruling; run only when asked for by name.
memory-mine
Run one deterministic, budgeted directed-capture batch for an explicit Claude Code project store. Use manual workspace mode only when cross-agent cass sessions are intentionally in scope.
papers
Search preprints from arXiv, bioRxiv, and medRxiv without API keys. Supports search, lookup, extraction, citations, enrichment, and paper downloads that bundle PDFs plus linked GitHub code.
papers
Search preprints from arXiv, bioRxiv, and medRxiv without API keys. Supports search, lookup, extraction, citations, enrichment, and paper downloads that bundle PDFs plus linked GitHub code.
wsl-cdp
Drive the user's real, logged-in Windows browser (Chrome, Edge, or Brave) from a Claude Code session running inside WSL2, over the Chrome DevTools Protocol - read authenticated dashboards and consoles, take real screenshots, open and read pages with the user's sessions. Use when a task needs the user's existing web logins and the session runs in WSL2, where the Claude in Chrome extension cannot work. Not for native-Windows or macOS Claude Code (use the official Claude in Chrome extension), not for anonymous scraping or CI (use headless Playwright inside WSL), not for getting past login walls (those are handed to the human).
token-eater
[BETA] Spend a subscription's idle, about-to-expire credits on safe, machine-verified cleanup. You pick the service (Grok / Codex / Claude) and a token-heavy maintenance skill (de-monolithize, de-slop, simplify, dead-code); that service runs the whole skill -> gate -> self-review -> draft-PR loop on its own credits, in an isolated worktree. token-eater verifies the gate and never merges. Manual invocation only during beta.