Mobile App

Download

Android app coming soon (beta). Join the waitlist at getafk.dev/download.

Sign In

AFK supports two ways to sign in: magic link email and QR code pairing.

Magic Link (Email)

1. 1 Open the AFK app and tap Sign In with Email
2. 2 Enter your email address
3. 3 Check your email for the magic link and tap it to sign in
4. 4 Alternatively, enter the 8-digit code from the email if you don't have access to email on your mobile device

QR Code Pairing

1. 1 Run afk stream claude, afk stream opencode, afk stream codex, etc. — a QR code appears in the terminal
2. 2 Open the AFK app and tap Scan QR Code
3. 3 Point your camera at the QR code
4. 4 You're paired and ready to go

No password required. If you're already logged in on desktop, your auth transfers automatically to the mobile app. Otherwise, QR pairing creates an anonymous account that you can link an email to later.

Login QR (Transfer Desktop Auth)

If you're already signed in on desktop and want to sign in on your phone without entering an email:

1. 1 Open the AFK app and tap Scan QR Code on the login screen
2. 2 Scan the QR code shown in the terminal when you run afk stream
3. 3 Your desktop login is transferred to the mobile app — you're signed in immediately with your full account

This is the fastest way to get started if you already have an AFK account on desktop. Users who sign up via QR code also get a 7-day Pro Trial.

Sessions List

The main screen after sign in. Shows all your active terminal sessions as cards.

• Session cards — Each card shows the command, directory, host, and how long the session has been running
• Subscription banner — Shows your current plan status (Free, Trial, Pro, Referral credit). See Subscription & Referral
• Empty state — When no sessions are active, shows instructions to start one from the CLI
• Menu — Access Settings, Analytics, and Support from the top navigation
• New Session — If the daemon is running on your desktop, tap the + button to spawn a new session remotely. See Command Reference for afk daemon

Terminal

Tap a session card to open the full-screen terminal view. The terminal is rendered natively using Metal (GPU-accelerated) for crisp text and smooth scrolling at 60fps.

• Status banner — Shows connection state (connecting, connected, reconnecting, no connection) at the top
• Scroll controls — Swipe to scroll through terminal history. Tap the bottom to jump back to the latest output
• Font size — Pinch to zoom or adjust in Settings
• Idle warning — A notification appears if the session has been idle for an extended period
• FPS monitor — Optional overlay showing rendering performance (enable in Settings)
• Auto-approve — For Claude Code sessions, toggle auto-approve from the toolbar to automatically accept tool use prompts. Shows a count badge of auto-approved actions. Pro feature

Terminal Input

Tap the terminal to bring up the keyboard. A special keys toolbar appears above the keyboard for common terminal shortcuts.

Hardware keyboards are fully supported — connect a Bluetooth keyboard for a desktop-like experience.

Voice Input

Speak commands instead of typing. AFK uses high-precision speech-to-text optimized for code and terminal workflows.

• Always-on mic indicator — Shows when the microphone is active
• Auto-submit — Voice input is automatically sent to the terminal when you finish speaking, using Deepgram's speech finalization signal. No need to press send
• Configurable pause sensitivity — Adjust how long AFK waits after you stop speaking before submitting (Deepgram endpointing)

Free plan includes 20 voice commands/month. Pro unlocks unlimited Precision Voice Input. See Subscription & Referral.

Settings

Access from the menu icon on the Sessions List screen.

• Account info — View your user ID, email (if linked), and subscription status
• Server config — Backend server URL (default: getafk.dev)
• Terminal preferences — Font size and FPS monitor toggle
• Debug logging — Toggle detailed file logging for troubleshooting (developer setting)
• Log viewer — View diagnostic logs (visible when debug logging is enabled)
• Delete Account — Permanently delete your account and all associated data
• Logout — Sign out and clear stored credentials

Analytics

View your usage statistics from the menu on the Sessions List screen.

• Session stats — Total sessions, total duration, data transferred, commands sent
• Daily chart — Visual breakdown of your activity over time
• Voice activity — Track your voice command usage

Support

Need help or found a bug? Submit support tickets directly from the app. Pro subscribers get Priority Support with faster response times.

• Submit a ticket — Describe the issue with optional screenshots. Access from the menu or shake your device
• View & reply — See your previously submitted tickets, their status, and reply to follow up
• Shake gesture — Shake your device to quickly open the support form

Link Email

If you signed in via QR code pairing, you have an anonymous account. Link an email to unlock additional features.

1. 1 Go to Settings and tap Link Email
2. 2 Enter your email address
3. 3 Enter the verification code sent to your email

Linking an email enables:

• Referral program — Share your referral code to earn free Pro months
• Account recovery — Sign in on a new device with your email
• Device management — Access your account across multiple devices