Skip to content

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.