alto ls
List running sessions, and what each is doing
In context: Your first sessions.
Usage
List running sessions, and what each is doing
Usage: alto ls [OPTIONS]
Options:
--json Print them as JSON: each one's id, program, folder, status (who typed last, whether agents are paused) and work panes. With --all, every machine and session, each with its address, and the groups
--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
-a, --all Every session on every machine you reach, each named as `machine:id`; one not answering shows what it said last
--in <SELECTOR> Only those matching all of these words (implies --all): a machine's (`os:windows`, `has:claude`, `kind:vm`, `pool:NAME`, its name…) and a session's (`status:needs-you`, `agent:claude`, `repo:NAME`)
--group-by <KEY> Group them (implies --all): machine (the default), pool, kind, provider, os, tag, repo, agent, status or none
--waiting Only those waiting for you (a permission prompt, a question, a bell), here and on every other device you reach, newest first (implies --all). As JSON: `waiting` (each with its `device` and `session`), `silent` (devices not answering, and why) and `asked`
--count How many in each group are working, need you or are done, rather than each session (implies --all)
--workspace <NAME> Only the sessions in this workspace, wherever they are, each with its state (as `workspace show`). With --waiting, only those of its sessions waiting for you. `machine:NAME` for one kept elsewhere
-h, --help Print help
Generated from alto 0.0.1 by tools/export-reference.py.