Your first remote session

Take a local checkout to a machine you own, then start a development session that can survive a disconnected terminal.

Before you begin

Install Schooner on your local machine. Have an Ubuntu 24.04 or 26.04 machine you can already reach over SSH, and a local Git checkout to work with.

Run the commands below in your local terminal. repository stands for the path to your checkout.

1. Connect your machine

schooner box add

Choose the existing SSH machine option. The guided flow asks for a Box name, your SSH destination, and a worktree location. Use the SSH alias or user@host you already connect with, and review the setup before confirming.

Schooner prepares Git, tmux, and its remote runtime for that SSH user. Your machine is now a Box in Schooner. Ordinary SSH access continues to work.

Already know the name and SSH destination?

You can fill those values in ahead of the prompts:

schooner box add work-api --ssh work-api

Here, the first work-api is the Box name; the second is an existing SSH host alias. These arguments are optional in the interactive flow.

2. Send your checkout

cd repository
schooner push

With one configured Box, Schooner selects it automatically. If you have several, it uses the checkout’s existing link or your saved default, then offers a choice if needed.

push transfers the checkout to a remote Worktree and remembers the route. If several matching remote Worktrees exist, the interactive flow lets you choose one. Review any source-access or transfer prompts.

3. Start working

From the same checkout:

schooner start

Schooner follows the route remembered by push to open persistent work on the remote Worktree. You do not need to repeat the Box name or repository path.

Come back later

After disconnecting, return to that local checkout and run:

schooner resume

Continue with resuming your work, or read how command defaults work when you need to choose a different Box or Worktree.

Checked against the CLI implementation at 03d6623 and its Box selection rules.