Skip to main content

OAuth Providers

Access premium AI models with browser authentication. No API keys, no config files. Just ccs gemini and start coding.

Available Providers

ProviderCommandModels
Geminiccs geminiGemini 2.5 Pro, 2.0 Flash, Flash Lite
Codexccs codexo1, GPT-4o, GPT-4o-mini
Antigravityccs agyAntigravity Pro, Turbo

How It Works

1

First Run

Run ccs gemini "your prompt" (first time)
2

Browser Opens

Browser opens → Complete OAuth login
3

Token Cached

Token cached at ~/.ccs/cliproxy/auth/
4

Future Runs

Future runs → Instant, no re-auth needed

Quick Start

# Gemini (free tier available)
ccs gemini "explain this codebase"

# Codex (requires ChatGPT Plus)
ccs codex "implement auth flow"

# Antigravity
ccs agy "analyze this code"

Benefits

Zero API Keys

No API key signup, no env vars, no config files

Premium Models

Access Gemini 2.5 Pro, GPT-4o via subscriptions

Auto Refresh

OAuth tokens refresh automatically - more secure than static keys

Headless Mode

--headless flag for servers without browser

Commands Reference

Basic Usage

ccs gemini "your prompt"
ccs codex "your prompt"
ccs agy "your prompt"

Auth Management

ccs gemini --auth      # Auth only, no session
ccs gemini --logout    # Clear tokens
ccs gemini --headless  # No browser mode (get URL for remote auth)

Headless Mode

Working on a server without browser? Use --headless flag:
ccs gemini --headless

# Output:
# Open this URL on any device to authenticate:
# https://accounts.google.com/...
#
# Waiting for authentication...
Complete auth on another device, and CCS will detect when tokens are cached.

Dashboard Configuration

Configure OAuth providers visually:
ccs config
OAuth Providers Configuration

Cost Information

ProviderCostNotes
GeminiFree tier availableGoogle account required
CodexChatGPT Plus subscriptionPremium OpenAI models
AntigravitySubscriptionCheck provider for current pricing