Crewship

Turn a fresh Ubuntu machine into a reproducible AI-agent coding host: Herdr, Firstmate, the omp agent fleet, and the Concord and slk chat clients, provisioned by Ansible from a checksum-verified toolchain.

Ship's manifest

  • Configuration

    The helm. .local/host.yml, the ./ship.sh commands, and what each profile installs

  • Dependencies

    The cargo hold. Every tool, package, and image the recipe installs, and what the host must already have

  • Fleet guards

    The bow lantern. Shared Supabase, Docker guard, dev-server reaper, storage guard, spawn memory floor, browser ladder

  • Herdr sidebar

    The crow's nest. The Spaces and Agents sidebar layouts, what each line and token shows, the reporter timer and omp extension that feed them, and how to override them or turn parts off

  • herdr-patch

    The spyglass. Herdr over mosh: no opaque background fill, and real images with herdr-patch <user>@<host>

  • omp configuration

    The mast. Signing in, model roles, fallbacks, the advisor, and updating an existing host

  • Chat clients

    The radio mast. The Concord (Discord) and slk (Slack) terminal clients: install, config, and sign-in

  • iMessage bridge

    The ship's bell. Optional: text Firstmate over a Photon Spectrum iMessage line, with a front desk that steps in when Firstmate stays quiet, and send, reply, typing, tapback, and location commands

  • Capacity and pruners

    The barrels. Host sizing per lane count and every auto pruner

  • CI pool

    The containers. Self-hosted GitHub Actions slots: one job per fresh container, sized from half of the host's CPU and memory

  • Architecture

    The lighthouse. Why Ansible, host and container boundary, Docker worker, CI

  • Migration and recovery

    The lifeboat. New-device sequence, desktop access, troubleshooting, upgrades

  • Security

    The cabin. What is never exported, how to handle credentials, and remote access, including SSH between the host and a Mac and prompt-free Dia remote debugging on the Mac

  • Shared credentials

    The strongbox. super.env in Cloudflare Secrets Store: push, fetch on a new host, revoke

  • Google Workspace CLI

    The mailbox. gws: one OAuth client in testing mode, sign-in for several Google accounts, and carrying each login to a headless host

  • Agent host move

    The tender. Moving the agents to a new host: what to copy by hand, parity checks, cutover

  • More docs

    The docs board. More pages: GitHub board: Optional: one issue per Firstmate work item, a Project…; Crew board: Optional: a host-local, in-memory message board that…

  • Quick start

    The gangway. Rent an Ubuntu 24.04 or 26.04 server from any VPS or cloud provider, for example Hetzner Cloud, OVHcloud VPS, or DigitalOcean Droplets.

  • Crewship on GitHub

    The name on the bow. Orchestrate hundreds of agents effortlessly - hardware is the limit.

  • Releases (v0.3.0)

    The harbor office. The latest release is v0.3.0.

  • How this is built

    The notice board. How this harbor is drawn in text, how you move, and how it deploys.