Command Reference

Quick reference for every afk command. See the linked pages for detailed usage.

Streaming

afk stream [-- <command> [args...]]

Manually stream a terminal session. With no command, AFK uses your default shell.

Flags: --session-id --login --logout

afk connect [--session-id <id>]

Connect to any session (local or remote). Opens an interactive picker if no session ID is given.

Flags: --session-id --login --logout

afk sessions

List all local and remote sessions with status and details.

afk notify [<message>]

Send a push notification to your mobile devices.

Flags: --title --session-id --app --event-type

afk hooks install | status | remove

Manage Claude Code notification hooks.

afk status

Show current login status and token info.

afk whoami

Show who you are logged in as.

afk logout

Logout and delete stored authentication tokens.

afk --version

Show the installed AFK version.

afk --no-update <command>

Skip the automatic update check before running a command.