shed

Use case

Close the laptop

Move a running Claude Code session to a shed machine and keep it going after the lid shuts. Check on it from your phone.

An agent on your laptop stops when the laptop does: close the lid, lose the Wi-Fi, or let the battery run out, and the session ends mid-task. On a shed machine it keeps going, because the machine doesn't sleep when you do.

How it works

  1. Your agent pushes its work to a branch (or copies the folder) and starts a shed machine.
  2. It copies the conversation across and resumes it there, in tmux, with claude --resume and Remote Control on. It becomes a session of its own in the Claude app, separate from the one on your laptop.
  3. You sign in to Claude Code on the machine once, in its terminal. The sign-in stays on that machine.
  4. Close the laptop. Open the machine's page later, from any browser or your phone, and the session is where the agent left it. Turn on phone access to continue from the Claude app.

The steps are spelled out in the agents' guide, so your agent can do them for you.

Good to know

  • An open SSH session, a terminal tab, or Claude Code working all count as use, so the machine stays awake while the agent works. After an hour with nothing going on it goes to sleep, with its files kept.
  • A machine's address changes every time it starts; the page always shows the current one.

The prompt

Paste it into Claude Code, Codex or Cursor. The copy on the shed page adds the address and a new token for your account.

I want to close my laptop and keep this work going on shed. Commit and push what we have to a new branch (or plan to rsync it if there's no remote), then use this project's shed machine if I have one (start it if it's stopped), or start one for it (size m), put the code in ~/work, copy this conversation over and resume it in tmux with Remote Control on, exactly as the guide's "Hand off a Claude Code session" says. Tell me when to sign in to Claude Code on the machine, and when it's running, give me the machine's name and the session's name in the Claude app.
Copy the prompt

Read more