shipkit

Rust CLI + plugin

Ship a local folder to GitHub and a registry, one checked step at a time.

ship is one small CLI. Every release step is its own command and prints one JSON object, so Claude Code, a script or you can drive it step by step. Creating a repo, tagging a release and publishing are refused without --confirm.

  • One static binary
  • npm · PyPI · crates.io
  • MIT
  • macOS

01

What the setup does

Run the downloaded file and follow the wizard.

  1. Installs ship.exe for your account and adds it to your PATH, so ship works in any new terminal.
  2. If Claude Code is installed, it can also install the shipkit plugin (the skill, the safety hook and /ship-setup).
  3. Uninstalling takes it off your PATH and removes the plugin it added.

Other ways to install

With Rust
cargo install shipkit
Claude Code plugin
/plugin marketplace add acus9345/shipkit
/plugin install shipkit@shipkit
/shipkit:ship-setup
Check it
ship --version
ship self-test

On a Mac

  1. Installs ship to /usr/local/bin, which is already on your PATH. macOS asks for your password.
  2. One universal binary for Apple Silicon and Intel. Add the Claude Code plugin with the /plugin commands below.
  3. To remove it: sudo rm /usr/local/bin/ship && sudo pkgutil --forget io.github.acus9345.shipkit

02

What it does

From the project’s README.

Safe by default

create-repo, release and publish need --confirm. Every step has a --dry-run that prints exactly what it would run.

No tokens

Uses your existing gh, cargo, npm or uv login. Generated release workflows publish with OIDC.

Never overwrites

scaffold and add-workflows only create missing files. Tags are never moved or deleted.

Checks first

A secret scan and the registry dry run must pass before a commit, repo, release or publish.

One JSON object per step

Stable exit codes and error codes (E_CONFIRM_REQUIRED, E_SECRETS_FOUND, …), easy for an agent or script to read.

No telemetry

The only network calls are the ones a step needs. Every action is logged locally, with secrets redacted.

03

Requirements

  • Windows 10 or 11, x64, for the installer. A Linux x64 binary is on the releases page.
  • git and the GitHub CLI gh, logged in with gh auth login.
  • The tool for your registry: cargo, npm or uv. ship preflight checks them all.