@schoolai/shipyard

Ship together with AI — locally, visibly, confidently.

Shipyard is the collaboration workspace where engineering teams build alongside AI coding agents. This package provides the daemon, CLI, and MCP server.

Install

npm install -g @schoolai/shipyard

Or run directly:

npx @schoolai/shipyard --help

Quick Start

# Start Shipyard (authenticates on first run, opens browser automatically)
shipyard start

The start command handles everything: checks for auth, runs the device flow if needed (opens browser for GitHub sign-in), starts the daemon, and auto-opens the web app.

Commands

| Command | Description | |---------|-------------| | shipyard start | Start daemon (authenticates if needed, opens browser) | | shipyard start --code CODE | Start with a pre-authorized code from the web app | | shipyard login | Authenticate with Shipyard (device flow) | | shipyard login --check | Check current auth status | | shipyard logout | Clear stored credentials |

Options

| Option | Short | Description | |--------|-------|-------------| | --version | -v | Show version | | --help | -h | Show help |

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | ANTHROPIC_API_KEY | | API key for Claude (optional, overrides OAuth) | | SHIPYARD_DEV | | Set to 1 for dev mode (uses ~/.shipyard-dev/) | | SHIPYARD_WEB_URL | (auto) | Override browser URL for auto-open | | LOG_LEVEL | info | debug, info, warn, error | | SHIPYARD_SIGNALING_URL | (auto) | Signaling server WebSocket URL | | SHIPYARD_USER_TOKEN | (none) | JWT for signaling auth (from shipyard login) | | SHIPYARD_USER_ID | (none) | User ID for signaling path (from shipyard login) | | SHIPYARD_MACHINE_ID | os.hostname() | Machine identifier | | SHIPYARD_MACHINE_NAME | os.hostname() | Human-readable machine name |

Documentation

• Installation Guide
• Architecture
• Development

License

FSL-1.1-ALv2 (Functional Source License) - Free for all non-competing use, converts to Apache 2.0 in 2 years.