Cue Agent

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:

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