The Cue Agent runs natively on your computer, connected to your Cue account. Control it from your terminal or your phone.

​
How It Works

The Cue Agent runs in-process on your machine: 
Your Phone (iOS App)
       ↓ WebSocket
Cue Backend
       ↓ WebSocket
Your Computer (Cue CLI)
       ↓
Cue Agent (runs locally)
  • Same account — Uses your Cue login from the iOS app
  • Real-time sync — Send prompts from your phone, agent runs on your computer
  • Local execution — Tools run on your machine (file access, terminal commands)
  • Session persistence — Conversations saved to ~/.cue/projects/

​
Using the Agent

​
From Terminal

Start the CLI and chat directly: 
cue              # Start interactive mode
> Write a Python script to analyze my data
Or send a single prompt: 
cue -p "What files are in this directory?"

​
From Your Phone

Once authenticated, your iOS app can send prompts to your computer:
  1. Open Cue on your phone
  2. Select a coding conversation
  3. Send a message — it runs on your computer
  4. Get results back on your phone
This lets you control your computer’s AI agent from anywhere.

​
AI Providers

The Cue Agent supports multiple AI providers:
ProviderHow to Use
Cue (default)Uses your Cue account, no extra setup
AnthropicSet ANTHROPIC_API_KEY or use /auth new
OpenAISet OPENAI_API_KEY or use /auth new
GeminiSet GEMINI_API_KEY or use /auth new

​
Using Cue Backend (Default)

When logged in with your Cue account, requests go through Cue’s backend: 
cue
/login           # Login with your Cue account
> Ask anything   # Uses Cue's AI backend

​
Using Direct API Keys

For direct API access without going through Cue: 
cue
/auth new
# Choose provider: Anthropic, OpenAI, or Gemini
# Enter your API key
Or set environment variables: 
export ANTHROPIC_API_KEY=sk-ant-...
export OPENAI_API_KEY=sk-...
export GEMINI_API_KEY=...

​
Session Management

Sessions are stored locally and can be resumed: 
# List recent sessions
/sessions

# Resume a session
/resume <session-id>
Sessions are saved to ~/.cue/projects/{project-name}/{session-id}.jsonl.

​
Tools

The Cue Agent can execute tools on your machine:
  • File operations — Read, write, edit files
  • Terminal commands — Run bash commands
  • Code execution — Run scripts in your environment
Tools run locally with your permissions, giving the agent access to your development environment.

​
Next Steps

Utilities

Browse the command categories available through Cue CLI