Labsco
vercel-labs logo

autoship

★ 154

by vercel · part of vercel-labs/autoship

CLI tool for automated changeset-based releases with AI-generated descriptions. Use when the user needs to release a package, create changesets, bump versions,…

🔥🔥🔥✓ VerifiedAccount requiredNeeds API keys
#automation#devops#git
🧰 Not standalone. This skill ships with vercel-labs/autoship and only works together with that tool — install the tool first, then add this skill.

CLI tool for automated changeset-based releases with AI-generated descriptions. Use when the user needs to release a package, create changesets, bump versions,…

Inspect the full instructions your agent will receiveExpand

This is the exact playbook injected into your agent when the skill activates — shown here so you can audit it before installing. You don't need to read it to use the skill.

by vercel

CLI tool for automated changeset-based releases with AI-generated descriptions. Use when the user needs to release a package, create changesets, bump versions,… npx skills add https://github.com/vercel-labs/autoship --skill autoship Download ZIPGitHub154

Automated Releases with autoship

Core Workflow

Every release follows this pattern:

  • Configure: autoship add <name> (one-time setup)

  • Release: autoship <name> (interactive) or autoship <name> -t patch -y (automated)

The tool handles the complete release cycle:

  • Clone repository

  • Analyze changes and suggest release type (patch/minor/major)

  • Generate AI-powered changeset description

  • Create and merge changeset PR

  • Wait for and merge Version Packages PR

  • Trigger npm publish

Essential Commands

Copy & paste — that's it
# One-time setup: add a repository
autoship add myproject
# Prompts for: owner, repo name, base branch

# List configured repositories
autoship list

# Interactive release (prompts for type and message)
autoship myproject

# Automated release (no prompts)
autoship myproject -t patch -y
autoship myproject -t minor -y
autoship myproject -t major -y

# Release with custom message (skips AI generation)
autoship myproject -t patch -m "Fixed login bug" -y

Command Options

Copy & paste — that's it
autoship [repo] # Interactive repo selection if omitted
 -t, --type # Release type: patch, minor, major
 -m, --message # Custom changeset description
 -y, --yes # Skip all confirmations
 -h, --help # Show help

Common Patterns

Fully Automated Patch Release

Copy & paste — that's it
autoship myproject -t patch -y

AI-Assisted Interactive Release

Copy & paste — that's it
autoship myproject
# 1. AI analyzes commits since last release
# 2. AI suggests release type (patch/minor/major)
# 3. You confirm or change the type
# 4. AI generates changeset description
# 5. You review and approve
# 6. Tool handles PR creation and merging

Custom Message Release

Copy & paste — that's it
autoship myproject -t minor -m "Added new authentication providers" -y

CI/CD Integration

Copy & paste — that's it
# In GitHub Actions or CI pipeline
export AI_GATEWAY_API_KEY="${{ secrets.AI_GATEWAY_API_KEY }}"
npx autoship myproject -t patch -y

What autoship Does (10 Steps)

  • Clone - Clones the repository from the base branch

  • Analyze - Finds latest version tag, analyzes commits and diff

  • Suggest - AI suggests release type based on changes

  • Generate - AI generates changeset description

  • Branch - Creates release branch with changeset file

  • PR - Creates pull request for the changeset

  • Wait - Waits for CI checks to pass

  • Merge - Merges the changeset PR

  • Version PR - Waits for changesets action to create Version Packages PR

  • Publish - Merges Version Packages PR to trigger npm publish

Output Format

autoship provides clear step-by-step output:

Copy & paste — that's it
[1/10] Cloning repository from main...
 > Repository cloned
 > Package: my-package @ 1.2.3

[2/10] Creating release branch...
 > Branch created: release/patch-1706123456789

[3/10] Generating changeset...
 > Changeset created: fluffy-pants-dance.md

...

Release Complete!
The patch release has been published.

Deep-Dive Documentation

Reference When to Use references/commands.md Full command reference with all options references/configuration.md Config file format and repository setup references/ci-integration.md GitHub Actions and CI/CD setup

Ready-to-Use Templates

Template Description templates/automated-release.sh Fully automated release script templates/setup-repo.sh Non-interactive repository setup

Copy & paste — that's it
./templates/automated-release.sh myproject patch
./templates/setup-repo.sh myproject vercel-labs myproject main