ConnectOS CLI (ctos)

CLI for ConnectOS — integration and trust layer for AI executive systems.

Install

npm install -g connectos

Configure

Set environment variables or create ~/.ctosrc:

{
  "url": "https://your-connectos-server.up.railway.app",
  "tenantId": "your-tenant-id",
  "apiKey": "your-api-key"
}

Or use environment variables:

export CONNECTOS_URL="https://your-connectos-server.up.railway.app"
export CONNECTOS_TENANT_ID="your-tenant-id"
export CONNECTOS_API_KEY="your-api-key"

Usage

# Check server health
ctos status --pretty

# List connections
ctos connections --pretty

# Connect a provider (opens browser for OAuth)
ctos connect shopify --pretty

# Disconnect a provider
ctos disconnect shopify --pretty

# Get recommended OAuth scopes
ctos scopes shopify --pretty

# Fetch morning briefing
ctos briefing daily --pretty

# Get OpenClaw agent context
ctos context --pretty

Commands

| Command | Description | | ----------------------- | ---------------------------------------- | | status | Server health checks | | health | Readiness probe detail | | connections | List connections with status | | context | OpenClaw agent context snapshot | | connect <provider> | Start OAuth connection | | reconnect <provider> | Re-authorize a broken connection | | disconnect <provider> | Remove a connection | | scopes <provider> | Recommended OAuth scopes | | briefing <source> | Fetch briefing data | | approve | Manage write-lane approvals | | proxy | Execute API calls through trust boundary |

Requirements

• Node.js >= 22.6.0
• A running ConnectOS server

License

MIT