Command reference

Run aos with no command to start an interactive chat: each message is a Task.

Command	What it does
aos approve	Allow a pending Approval (–for-task: the same Tool in the same folder for the rest of the Task)
aos attach	Watch or type into a Task’s Session (Ctrl-] detaches; the Agent is told what you typed)
aos audit	Show the Audit Log, newest first
aos browser	Install or remove the Browser app (Chromium’s headless shell)
aos cancel	Cancel a Task
aos checkpoint	List, create or restore Checkpoints of the Machine’s software
aos config	Show or change settings (stored in /etc/aos/config.yml)
aos daemon	Control the aosd systemd service (start, stop, restart, logs)
aos deny	Deny a pending Approval
aos doctor	Show Mode, Landlock status and API key presence
aos follow-up	Continue a finished Task with a further instruction
aos memory	Memory: what every Agent is told about your preferences
aos mode	Show or switch the Machine’s Mode (ui or cli)
aos protect	Lock a path: Agents need your Approval to change it (no path: list Protected Paths)
aos reply	Answer a Task that is waiting for you: its question, or a hint after its Retries ran out
aos resume	Continue a Task that AOS stopping interrupted
aos run	Run one Task and wait for it (for scripts: without a terminal, calls that need an Approval are denied)
aos service	Services: programs AOS keeps running, also after restarts
aos show	Show a Task’s steps (–follow keeps watching)
aos software	Software installed through AOS: the Install Ledger
aos status	Show whether the Machine is running, its Mode, port and health
aos stop	Stop every Agent
aos tasks	List recent Tasks
aos trash	List, restore or empty the Trash
aos uninstall	Remove the systemd unit and the binary (–purge also deletes the account and all data)
aos unprotect	Unlock a path you locked