Skip to content

alto call

Ask a session to do one thing, by a method `describe` lists, with its arguments as JSON (`--args '{"last":20}'`, or `--args -` to read them from standard input). Prints what it gives back; the arguments are checked first, so a call refused changes nothing. Exits 2 when there's no such method or the arguments are wrong, 124 when it timed out, 125 when it couldn't, and `run`'s with the command's status

Usage

Ask a session to do one thing, by a method `describe` lists, with its arguments as JSON (`--args '{"last":20}'`, or `--args -` to read them from standard input). Prints what it gives back; the arguments are checked first, so a call refused changes nothing. Exits 2 when there's no such method or the arguments are wrong, 124 when it timed out, 125 when it couldn't, and `run`'s with the command's status

Usage: alto call [OPTIONS] <ID> <METHOD>

Arguments:
  <ID>      The session's id (`3`, or `studio:3`)
  <METHOD>  The method: send, capture, wait, run, pause, resume, kill

Options:
      --args <JSON>         The arguments, as a JSON object; `-` reads them from standard input
      --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
      --json                Print `{"ok": …}` or `{"error": {"code", "message"}}`
      --wait                For `message`: wait for the agent's reply (as `"wait": true`)
      --timeout <DURATION>  With --wait: how long (`30`, `500ms`, `2m`); 124 after it
  -h, --help                Print help

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