Commands

Complete reference for all AFK commands.

afk wrap

Start a terminal session and stream it to connected devices.

afk wrap <command>

Examples

# Stream a bash session

afk wrap bash

 

# Stream Claude Code

afk wrap claude

 

# Stream Python REPL

afk wrap python3

 

# Stream vim

afk wrap vim myfile.txt

Options

Option Description
--name <name> Set a custom session name
--server <url> Connect to a custom server

afk daemon

Run the AFK daemon in the background. The daemon keeps you logged in and can spawn sessions on-demand from mobile.

# Start daemon

afk daemon

 

# Start daemon in background

afk daemon &

With the daemon running, you can start new sessions from the mobile app without running afk wrap manually.

afk connect

List active sessions and connect to one from the terminal (for debugging or CLI access).

# List all sessions

afk connect

 

# Connect to a specific session

afk connect abc-123

afk login

Authenticate with the AFK server. Uses magic link email authentication.

afk login

Enter your email: [email protected]

Check your email for the magic link...

afk --version

Show the installed AFK version.

$ afk --version

afk 0.1.0

Environment Variables

Variable Description Default
AFK_SERVER Server URL thakerinnovations.com/afk
AFK_TOKEN Auth token (auto-managed) ~/.config/afk/token