ConnectOnion Auth (co auth)

August 15, 2026 · View on GitHub

One-time setup for managed models — no provider keys needed.

Quick Start

# Authenticate with OpenOnion (required first)
co auth

# Optional: Connect your Google account for Gmail & Calendar
co auth google

What co auth does:

  • Authenticates your agent and saves a secure token
  • Token is saved to ~/.co/keys.env as OPENONION_API_KEY
  • If your project has a .env, it's updated too
  • ~/.co/keys.env gains IS_EMAIL_ACTIVE=true

What co auth google does:

  • Connects your Google account for Gmail Send and Calendar Read
  • Opens browser for OAuth authorization
  • Saves credentials to .env for your agents to use
  • Running again will switch to a different Google account
  • See Google Integration for details

Use Managed Models (co/ prefix)

from connectonion import llm_do

response = llm_do("Hello", model="co/gpt-4o")

Works across providers:

  • co/gpt-4o, co/gpt-4o-mini
  • co/claude-sonnet-4-5, co/claude-haiku-4-5
  • co/gemini-3.7-flash (default), co/gemini-3.6-flash, co/gemini-3.5-flash, co/gemini-2.5-pro, co/gemini-2.5-flash

Troubleshooting

  • Missing token? Run co auth again
  • Network issue? Try again or check your connection
  • Global vs project: co auth prefers local .co if keys exist, otherwise uses ~/.co