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.