Skip to content

alto report

Say what a session's program is doing (for an agent, or its hooks): idle, working, needs-you or done. A program may also say what it is (--kind) and values of its own (--set), which `describe` and `ls --json` show until it ends. With nothing to say, show it. Without --session, the session this runs in

Usage

Say what a session's program is doing (for an agent, or its hooks): idle, working, needs-you or done. A program may also say what it is (--kind) and values of its own (--set), which `describe` and `ls --json` show until it ends. With nothing to say, show it. Without --session, the session this runs in

Usage: alto report [OPTIONS] [STATE]

Arguments:
  [STATE]  The state to report; leave out to show it

Options:
      --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
      --why <WHY>        A few words on why ("permission: Bash")
      --need <WHAT>      With needs-you, what it waits for: permission, question or auth (signing in)
      --agent <AGENT>    Who's reporting ("claude")
      --ended            The agent has ended: its reports stop counting
      --kind <WORD>      What this program is, as one word (`build`, `server`), in place of what the session would say (agent, shell, job)
      --set <KEY=VALUE>  A value of this program's own state, `KEY=VALUE` (`stage=tests`); again for more, and `KEY=` removes one
  -s, --session <ID>     The session's id (default: the session this runs in)
      --json             Show it as JSON (`state`, `since`, `why`, `agent`, and the rest `ls --json` gives each session)
  -h, --help             Print help

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