# Run iFlow for the first time
ccs iflow "review this code"

# Browser OAuth flow starts automatically
# → Browser opens for iFlow OAuth consent
# → Callback server spawns on port 11451
# → Token cached at ~/.ccs/cliproxy/auth/
# → Future runs require no re-auth

Authenticate with iFlow:
Opening browser for OAuth authentication...
Callback server listening on port 11451...

Browser opened for authentication.

# Authenticate without starting a session
ccs iflow --auth

# Headless mode (server/SSH environments)
ccs iflow --headless
# → Displays URL for manual browser authentication
# → Includes SSH tunnel instructions if needed

# Clear all iFlow tokens
ccs iflow --logout

# Add new account (preserves existing)
ccs iflow --auth --add

# Show all authenticated iFlow accounts
ccs iflow --accounts

# Output:
# Accounts for iflow:
#   [default] work (work@company.com)
#   personal (personal@example.com)

# Switch to specific account by nickname
ccs iflow --use personal

# Next command uses personal's account
ccs iflow "your prompt"

# Rename default account nickname
ccs iflow --nickname primary-account

# Open web config interface
ccs config

# Navigate to CLIProxy → iFlow settings

{
  "env": {
    "ANTHROPIC_MODEL": "iflow-model-name",
    "ANTHROPIC_MAX_TOKENS": "8192"
  }
}

# Run with iFlow
ccs iflow "analyze this database schema"

# Interactive chat
ccs iflow

{
  "type": "iflow",
  "access_token": "...",
  "refresh_token": "...",
  "email": "user@example.com",
  "expired": "2024-12-31T23:59:59Z"
}

# Verify token file exists
ls ~/.ccs/cliproxy/auth/iflow-*.json

# Re-authenticate if missing
ccs iflow --logout
ccs iflow --auth

# List all accounts to verify state
ccs iflow --accounts

# Switch to specific account
ccs iflow --use <nickname>

# Re-authenticate
ccs iflow --auth