How-to guides
One task per page.
| Guide | Task |
|---|---|
| Install | Install, update or build the client |
| Add a host | Connect any host you can reach with SSH, with the guided setup or by hand |
| Install agents | Pick agents from a checklist, or install one with its own installer, then log in |
| Pass secrets | Give a session an API key from your keychain or password manager, never stored |
| Get alerts | Hear from a session that needs you, with the laptop shut: ntfy, webhooks, commands |
| Bring work to your laptop | Fetch a session’s branch into your own clone |
| Worktrees | Give each task its own git worktree and branch |
| Setup hooks | Prepare each new session or worktree with the repository’s own script |
| Ports | Open a web server that runs in a session |
| Keep your scrollback | Start agents inline, so your terminal keeps the conversation |
| Paste images | Paste a screenshot into a remote agent |
| Restore after a reboot | Bring sessions back after the host restarts |
| Change keys | Rebind the launcher’s keys and the detach key |
| Troubleshoot | Find out what is wrong, and fix it |
| Uninstall | Remove the client, and the helper from your hosts |