Skip to content
pier pier

Your first session

From inside any git repo:

$ cd ~/code/shop && pier checkout-flow
creating checkout-flow (shop @ HEAD)
  ▸ launching t4g.medium (baked image)
  ▸ pushing secrets + repo (GitHub-first: only secrets ride the tunnel)
  ▸ bootstrap: branch checkout-flow, dirty patch applied, setup running
session checkout-flow ready

tmux opens on the VM. Your agent is installed, authenticated, and sitting on branch checkout-flow. Uncommitted edits to tracked files came along as a git patch.

See what the agent builds

Section titled “See what the agent builds”

In a second terminal, every session’s ports are one hostname away:

$ pier proxy
proxy up — running sessions resolve as <session>.pier (http + https), ports mirror on localhost too; ctrl-c to stop

The agent’s dev server is live in your browser at http://localhost:3000, or at http://checkout-flow.pier:3000 when two sessions hold the same port.

Walk away

Section titled “Walk away”

Detach with C-b d and close the laptop. The session keeps working without you. Once the agent goes quiet past the idle timeout, the supervisor parks the VM:

$ pier ls
NAME           REPO  STATE   AGE  COST
checkout-flow  shop  parked  3h   ~$3-4/mo

Come back

Section titled “Come back”
$ pier attach checkout-flow
resuming checkout-flow (~20-30s)...

Right where you left it. Files, git state, and installed tools survive parking. Running processes do not, so restart your dev server or agent after a resume.