Nomad Dev

Nomad Dev

Why this exists

Nomad Dev exists to make mobile-first AI coding practical in the real world.

Most remote workflows break down on phones because sessions die, reconnects are painful, and setup is inconsistent across machines. Nomad Dev gives you a repeatable way to run coding agents on a VPS while controlling everything from your phone.

Value delivered

• Faster setup: provision and bootstrap a host with repeatable scripts.
• Resilient sessions: use tmux, Mosh, and Tailscale for unstable networks.
• Mobile-first operation: run Codex or Claude Code from iOS/Android terminal apps.
• Notification loop: receive ntfy prompts when an agent needs input.
• Security-first defaults: no public SSH by default, explicit opt-in for less secure settings.

Who this is for

• Engineers who want to run AI coding agents from mobile devices.
• People comfortable with command-line tools and cloud infrastructure basics.
• Teams that want a sharable template for secure remote dev hosts.

Who this is not for

• Users looking for a no-CLI, GUI-only workflow.
• Production multi-tenant hosting of untrusted workloads.
• Mobile app build pipelines by themselves (this is an agent-host workflow toolkit).

High-level architecture

1. Pulumi provisions an Ubuntu 22.04 EC2 host.
2. Bootstrap installs core tools (git, tmux, mosh, tailscale).
3. scripts/nomad-dev installs repo-local notification helpers into target repos.
4. On the phone, you connect through Tailscale (optionally Mosh) and run the agent in tmux.
5. ntfy notifications alert you when the agent is waiting for input.

Secure quickstart

For a complete walkthrough, use `/docs/human/quickstart.md`.

1. Provision infrastructure:

cd infra/pulumi-aws
npm ci
pulumi login
pulumi stack init dev
pulumi config set aws:region us-east-1
pulumi config set sshPublicKeyPath ~/.ssh/nomad-dev.pub
pulumi config set rootVolumeSizeGiB 30
pulumi up

1. Keep secure defaults (recommended):

• Leave `enablePublicSs