Skip to content
EN

Back to the catalog

autoship

vercel-labs/autoship · skills.sh

Open source Repository Open in the app JSON README (API)

About

Skill publicada por vercel-labs/autoship no skills.sh. Instale com: npx skills add vercel-labs/autoship@autoship

Details

Kind
Agent skills
Topic
Cloud & DevOps
Publisher
vercel-labs
Origin
skillssh
Category
ferramentas
Stars
162
Forks
10
Open pull requests
2
Last push
2026-09-16T20:31:56Z
Repository state
ativo
Language
TypeScript
License
Apache-2.0
Added
2026-10-06 04:46:01
Updated
2026-10-06 04:46:01
Origin id
vercel-labs/autoship/autoship

README

# autoship

<p>
  <a href="https://vercel.com/labs#past-experiments"><img alt="Vercel Labs Experiment" src="https://img.shields.io/badge/LABS-EXPERIMENT-0a0a0a.svg?style=for-the-badge&amp;logo=Vercel&amp;labelColor=000000" height="28"></a>
  <a href="https://www.npmjs.com/package/autoship"><img alt="npm version: autoship" src="https://img.shields.io/npm/v/autoship.svg?style=for-the-badge&amp;labelColor=000000" height="28"></a>
  <a href="https://github.com/vercel-labs/autoship/blob/main/LICENSE"><img alt="License: Apache-2.0" src="https://img.shields.io/github/license/vercel-labs/autoship.svg?style=for-the-badge&amp;labelColor=000000" height="28"></a>
  <a href="https://www.npmjs.com/package/autoship"><img alt="npm downloads per month: autoship" src="https://img.shields.io/npm/dm/autoship.svg?style=for-the-badge&amp;labelColor=000000&amp;label=npm%20downloads" height="28"></a>
</p>

CLI tool to automate changeset-based releases with AI-generated descriptions.

## Features

- **AI-Powered Release Analysis** - Automatically suggests release type (patch/minor/major) based on commit history and code changes
- **Smart Changeset Generation** - Generates clear, concise changeset descriptions using AI
- **End-to-End Automation** - Handles the full release workflow from clone to publish
- **CI Integration** - Waits for checks to pass before merging
- **Interactive & Headless Modes** - Use interactively or fully automated with `-y` flag
- **Multi-Repository Support** - Configure and manage multiple repositories
- **Changesets Compatible** - Works with any repository using the changesets workflow

## Requirements

- **Node.js** 18+
- **Git**
- **GitHub CLI** (`gh`) - authenticated with repo access
- **AI_GATEWAY_API_KEY** environment variable

The target repository must use [changesets](https://github.com/changesets/changesets) for versioning.

## Setup

### 1. Authenticate GitHub CLI

```bash
gh auth login
```

### 2. Set your API key

```bash
export AI_GATEWAY_API_KEY=your-key
```

### 3. Add a repository

```bash
npx autoship add myproject
```

You'll be prompted for:
- GitHub owner (org or username)
- Repository name
- Base branch (default: `main`)

## Usage

### Start a release

```bash
npx autoship [repo]
```

If no repo is specified, you'll be prompted to select one.

The tool will:
1. Clone the repository
2. Analyze changes since the last version tag
3. Suggest a release type (patch/minor/major) using AI
4. Generate a changeset description using AI
5. Create a PR with the changeset
6. Wait for CI checks to pass
7. Merge the changeset PR
8. Wait for the Version Packages PR (created by changesets action)
9. Merge the Version Packages PR to publish

### Options

```
-t, --type <type>     Release type: patch, minor, or major
-m, --message <msg>   Release description (skips AI generation)
-y, --yes             Skip all confirmations
```

### Examples

```bash
# Interactive release
npx autoship myproject

# Patch release with custom message
npx autoship myproject -t patch -m "Fixed login bug"

# Fully automated minor release
npx autoship myproject -t minor -y
```

### List configured repositories

```bash
npx autoship list
```

## Configuration

Config is stored at `~/.autoship/config.json`.

## Usage with AI Agents

### Just ask the agent

The simplest approach - just tell your agent to use it:

```
Use autoship to release my package. Run autoship --help to see available commands.
```

### AI Coding Assistants

Add the skill to your AI coding assistant for richer context:

```bash
npx skills add vercel-labs/autoship
```

This works with Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Goose, OpenCode, and Windsurf.

### AGENTS.md / CLAUDE.md

For more consistent results, add to your project or global instructions file:

```markdown
## Package Releases

Use `autoship` for releases. Run `autoship --help` for all commands.

Core workflow:
1. `autoship add <name>` - Configure repository (one-time)
2. `autoship <name> -t patch -y` - Automated release
```

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

```bash
# Clone the repo
git clone https://github.com/vercel-labs/autoship.git

# Install dependencies
pnpm install

# Run tests
pnpm test

# Build
pnpm build
```

## License

Apache-2.0

More