cosscom/shipyard

What it solves

Shipyard provides a way to run coding agents (like Claude Code or Codex) on remote development machines (VPS, cloud VMs, or desktops) while managing them from a local laptop. This ensures that agents continue working even if the local machine is disconnected, sleeps, or loses Wi-Fi, as the actual execution happens on the remote "box".

How it works

The system consists of three main components:

• berthd: A daemon that runs on the remote box, managing worktrees, sessions, services, and agent execution.
• berth: A CLI and background agent on the laptop that handles connections and API requests.
• The App: A desktop application (Tauri/React) that provides a visual interface to steer agents, monitor progress via a kanban board, and manage remote worktrees.

Users pair their laptop to remote boxes via a pairing link or SSH. Once connected, they can create projects and assign tasks to agents using the CLI or the app.

Who it’s for

Developers who use AI coding agents and want to move the compute and execution environment to a remote server to avoid local resource constraints or to ensure uninterrupted agent progress.

Highlights

• Persistent Agent Execution: Agents run on the remote box, meaning they don't stop when the laptop is closed.
• Worktree Management: Each project gets its own ports, environment, and services, with private URLs for dev servers.
• Web-based Terminals: Integrated terminals (ghostty-web) and browser tabs for remote dev servers.
• Agent Orchestration: Ability to prompt, wait, check, and hand off tasks between different agents.
• Automations: Zapier-style flows triggered by events, schedules, or GitHub activity.
• Plugin System: Extensible app interface with built-in plugins for git changes, PRs, and box monitoring.