Skip to content

alto new

Start a session and print its id. Runs your login shell unless a program is given after `--`

In context: Your first sessions.

Usage

Start a session and print its id. Runs your login shell unless a program is given after `--`

Usage: alto new [OPTIONS] [-- <PROGRAM>...]

Arguments:
  [PROGRAM]...  

Options:
      --attach            Then show it in this terminal, as `attach` does
      --on <DEVICE>       Work with the sessions on another device, paired with before (`alto devices`), or one of your own on Tailscale by its name there: for the session commands (ls, new, attach, send, run, wait, capture, kill, pause, resume, fetch, work). A session named `studio:3`, as `ls --all` prints it, needs no --on
  -c, --cwd <FOLDER>      Folder to start in (default: the current one; with --on, the home folder there)
      --in <SELECTOR>     Somewhere that fits, of every device you reach: all of `os:windows`, `arch:aarch64`, `has:claude`, `tag:build`, `kind:vm`, `gpu`, `pool:NAME` (from settings.toml) or a device's name; the least busy that isn't drained or full. Prints the device, then the id (`studio 3`), for `--on`
      --repo [<PATH>]     Start in a checkout of this repository (default: the one here) at its current commit, on a branch of its own, `alto/<device>-<id>`, in that device's own copy of it. Commits the device can't fetch from the remote are sent; changes not committed aren't. `alto fetch` brings the branch back
      --workspace <NAME>  Add it to this workspace (kept here), making the workspace if it isn't there; wherever the session lands, by its address
  -h, --help              Print help

Generated from alto 0.0.1 by tools/export-reference.py.