Cue CLI is the foundation of Cue OS. It runs the agent on your machine and exposes a curated, all-in-one command system so humans do not have to wire many separate tools, approvals, or custom skill flows by hand. It works for Cue’s own agent and for third-party agents such as Codex, Claude Code, and Gemini. The CLI is where utilities, auth, background execution, and machine-local context come together.

​
Why It Exists

Without Cue CLI, an agent builder usually has to:
  • install many one-off tools or servers
  • configure separate credentials for each service
  • invent custom command wrappers for every workflow
  • ask the human to keep confirming setup details
Cue CLI replaces that with one runtime, one command surface, and a set of utilities that already work together.

​
What It Provides

  • Utility commands for web, weather, places, notifications, activity, publishing, files, projects, and more
  • Consistent command discovery with cue -h and cue commands grouped by category, plus --json support for automation
  • Auth routing for Cue accounts and direct provider keys
  • Background mode so your machine stays connected while you are away
  • Third-party agent support so external agents can use the same utility layer instead of bespoke tooling

​
Why iOS Pairs with It

Cue CLI is the runtime. iOS is the human-facing communication layer. Use the iOS app when you want to:
  • receive push notifications from cue notify
  • see what the agent did through Activity and Pulse
  • reply when the agent is blocked or needs confirmation
  • view posts and other output the agent shares with you

Setup

Shared setup for macOS and Linux, plus Windows notes

Auth

Manage accounts and API keys

Utilities

Browse the utility categories exposed through Cue CLI

​
Core Commands

cue commands
cue web search "AI agent platform" --json
cue weather current '{"location":"San Francisco"}'
cue notify "Build done" "Open Cue to review" system
cue activity "Report published"
cue post "Deployment summary is ready" --title "Daily update" --visibility private
cue skill search weather --source remote --json

​
Setup Flow

Install Cue, validate it, then connect your account: 
curl -fsSL https://cueos.ai/install.sh | bash
cue --version
cue -m doctor --json
cue setup
To try the dev channel instead of stable: 
curl -fsSL https://cueos.ai/install.sh | bash -s -- --channel dev
For install and auth details, use:

​
Background Mode

Run Cue as a background service that stays connected and receives commands from your phone or web app.

​
Commands

cue -m start       # Start the daemon and client
cue -m stop        # Stop everything
cue -m restart     # Restart the client (after updates)
cue -m status      # Check status

​
Install as System Service

Auto-start on login and auto-restart on crash: 
cue -m install     # Install system service
cue -m uninstall   # Remove system service

​
Switching AI Keys

The daemon uses your default account and its selected AI key: 
cue auth use anthropic:api   # Switch AI key
cue -m restart          # Restart to apply

​
Next Steps

Setup

Install and validate Cue CLI on macOS or Linux

Auth

Manage Cue accounts and provider keys

Utilities

Use the foundation, communication, identity, and workspace commands