shipyarddocs
shipyarddocs

Documentation

Shipyard documentation

Run coding agents on your own dev boxes, and work with them as if they were on your laptop.

Shipyard connects a laptop to any number of development machines (a VPS, a cloud VM, a desktop under your desk) and gives each repository on them worktrees, terminals, agents, dev servers and automations. The agents run on the boxes, so closing the app, sleeping the laptop or losing Wi-Fi never stops them; the app is a view you can close and reopen at any time.

Get started

curl -fsSL https://berthd.app/install | sh

Run that on your box, as the user your agents will run as. It installs berthd with no root, starts it, installs the hooks that let agents report their state, and prints a link: paste it into Add a box in the desktop app, or into berth pair on your laptop.

On your Mac, download Shipyard, drag it to Applications and open it. It's signed and notarized, runs on Apple silicon and Intel, carries the berth CLI, and updates itself. Every step is in install.

Start here

What it does

  • Workspaces per worktree. Terminals, splits, and browser tabs onto each worktree's dev server, at private URLs like http://checkout.shop.devl.localhost:1377/.
  • Agents you can see and steer. Claude Code, Codex and others, with a dashboard of who needs you, a review inbox for finished work, and orchestration (prompt, wait, check, loop, hand off) from the app, the CLI, or other agents.
  • Projects set up the same everywhere. Each worktree gets its own ports, environment, services, hooks and flows, from the repository's .berth/config.json, a shareable kit, or the box's own config.
  • Automations. Flows on events, schedules or GitHub activity, running on the box; plus plain shell hooks and gates.
  • Plugins. React plugins for the app, with built-ins for git changes, pull requests, dev servers, box monitoring, activity and notes.
  • Boxes without the fuss. Pinned mutual TLS, pairing by link, boxes on other tailnets, self-upgrade over Shipyard's own connection, and a phone companion served by each box.

The pieces

PieceWhat it is
berthdThe daemon on each box: worktrees, sessions (tmux), services, hooks, flows, kits.
berthThe laptop CLI and background agent: connections, private URLs, the app's API.
app/The desktop app (Tauri, React, coss ui).
plugins/Built-in plugins, written against packages/plugin-sdk.

Read how Shipyard works for the whole picture, or the security model before you pair a box you care about.

On this page