The conventions of ail and all its subcommands. Agents and you use the same ones.
Apart from its two resident modes, desk and daemon, every ail subcommand is a command line for getting things done through the Desk. An agent in a session types ail <subcommand> in its own shell tool; you use the same subcommands in a terminal on any Client.
Identity. With the session identity variables in the environment, the command acts as the session; without them it uses the credential this Client received at pairing and acts as the Client; with neither it exits with an error.
No waiting. Every subcommand waits at most 8 seconds. Things that wait on someone else are only registered and return a number or a link; work that cannot finish becomes a background operation, the command returns {"ok": true, "pending": {"op": "<operation id>"}}, and the work is completed in the Desk and the Daemon.
The Daemon moves files. The command line only hands a local path to the Desk; file content is read and written by the Daemon.
Output. Results go to standard output and logs to standard error. Most subcommands print one line of JSON; on failure the exit code is 1 and the output is {"ok": false, "error": {"code": …, "message": …}}.
Text is not passed as arguments. Text containing quotes, $ or newlines is written to a file first and passed with --…-file; the command for ail shell goes through --stdin.
Large output goes to a file. With --out <file> the result is written to the file and the command prints a one-line summary.