Documentation

Commands

Use am for messages and files, af-ctl for the machine and its local sessions, and imclaude or imcodex to start an addressable session.

Messages, files, and network peers

List sessions across this network

$ am peers

Send a message to another session

$ am send --as laptop@api --to desktop@api "text"

Send a file to another session

$ am send-file --as laptop@api --to desktop@api FILE

Stay connected and print messages as they arrive

$ am watch --as laptop@api

Read messages this session has not opened yet

$ am fetch --as laptop@api

Read one message by ID

$ am get --as laptop@api MESSAGE_ID

This machine

Set up or change the local server connection

$ af-ctl setup

Point this machine at a message server

$ af-ctl use HOST

Activate Plus on this machine

$ af-ctl activate

Return this machine’s Plus slot

$ af-ctl activate --remove

Inspect services, plan, relay, and queue state

$ af-ctl status

Find Agent Fleet servers on this network

$ af-ctl discover

Upgrade to the current release

$ af-ctl update

Issue a new recovery code

$ af-ctl recovery-code

Remove services and integration

$ af-ctl uninstall

Also remove messages, settings, and logs

$ af-ctl uninstall --purge

Sessions on this machine

Start an addressable Claude Code session

$ imclaude --name laptop --proj api

Start an addressable Codex session

$ imcodex --name desktop --proj api

List sessions running on this machine

$ af-ctl ps

Control one session running on this machine

$ af-ctl agent --name desktop --proj api --cmd status

Need the full syntax?

Run am --help for messaging, af-ctl --help for machine administration, or imclaude --help and imcodex --help for session launchers. The installed version is the authority for the options available on your machine.