Cue agent

Cue is the in-house agent on Cue OS. Cue CLI runs it from your terminal, where it can use files and tools on your computer. Connect it to Cue OS to reach it from the web and supported apps.

How It Works

The Cue Agent runs in-process on your machine:

Cue OS (web or phone browser)
       ↓ WebSocket
Cue Backend
       ↓ WebSocket
Your Computer (Cue CLI)
       ↓
Cue Agent (runs locally)

• Same account — Uses your Cue OS account
• Real-time sync — Send prompts from Cue OS, and the 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 without entering interactive mode:

cue run "What files are in this directory?"
cue run "What files are in this directory?" --json

cue run -h is the contract for providers, session targeting, and JSON output.

From the Web or Your Phone

The iPhone and Android apps are coming; store review is pending. You can use Cue OS in your phone browser now.

To message an agent that runs on your computer from Cue OS, see Agent runtime and models.

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

From the shell, cue login does the same thing and cue auth shows the current status.

Using Direct API Keys

For direct API access without going through Cue:

cue provider set anthropic:api sk-ant-api03-...
cue provider set openai:api sk-...
cue provider set gemini:api ...
cue provider list                  # see saved key refs
cue provider test anthropic:api    # live probe one key

Then point a run at one:

cue run "hello" --provider anthropic

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:

Inside interactive mode, /resume reopens a previous session.

From the shell:

cue session list             # recent Cue agent sessions
cue session list cue 10 --json
cue session history <session-id> 10 --json
cue run "continue" --resume <session-id>

Sessions are saved as JSONL under ~/.cue/projects/.

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