How openonion/connectonion works
ConnectOnion is an agent CLI harness: users invoke co commands to configure identity and credentials, run coding agents or hosted agents, and connect agents to accounts, tools, and other services. A separate co rem workflow maintains local context from work sources and supports investigation and project pages. The graph follows documented capabilities and source-index references; integrations and hosted-runtime links with no sampled call path are marked dashed and unverified.
Main entry points: service.py REM Maintenance · main.py `co` CLI · server.py Agent Host · rem_commands.py REM Commands
Components 22
CLI and Identity
- `co` CLI
connectonion/cli/main.py - Agent Identity
connectonion/address.py - Environment Config
connectonion/environment.py - Coding Agent CLI
connectonion/cli/co_ai/main.py
Agent Runtime
- Agent Loop
connectonion/core/agent.py - Model Providers
connectonion/core/llm.py - Tool Execution
connectonion/core/tool_executor.py - Usage and Costs
connectonion/core/usage.py
Hosting and Network
- Agent Host
connectonion/network/host/server.py - Host Authentication
connectonion/network/host/auth.py - Hosted Sessions
connectonion/network/host/session/storage.py
Context and REM
- REM Commands
connectonion/cli/commands/rem_commands.py - REM Maintenance
connectonion/rem/service.py - Context Sources
connectonion/rem/source.py - Local Notebook
connectonion/rem/files.py - Investigation
connectonion/rem/investigate.py - Project Pages
connectonion/rem/project_pages.py - Mail Archive
connectonion/rem/mail_archive.py
Tools and Integrations
- Browser Agent
connectonion/cli/browser_agent/client.py - Account and Web Tools
connectonion/useful_tools - Chat Inboxes
connectonion/inbox
Other components
- User
Connections 21
- User → `co` CLI: runs commands
- `co` CLI → Agent Identity: sets up identity
connectonion/cli/main.py - `co` CLI → Environment Config: loads settings
connectonion/cli/main.py - `co` CLI → REM Commands: dispatches REM
connectonion/cli/main.py - User → Coding Agent CLI: starts agent
- Coding Agent CLI → Agent Host: hosts agent
- Agent Loop → Model Providers: requests completions
connectonion/core/agent.py - Agent Loop → Tool Execution: executes tools
connectonion/core/agent.py - Model Providers → Usage and Costs: records usage
connectonion/core/llm.py - Agent Host → Host Authentication: uses authentication
connectonion/network/host/server.py - Agent Host → Hosted Sessions: persists sessions
connectonion/network/host/server.py - User → Account and Web Tools: connects accounts
- User → Browser Agent: uses browser
- User → Chat Inboxes: uses chat apps
- REM Commands → REM Maintenance: runs maintenance
- REM Maintenance → Local Notebook: reads and writes
connectonion/rem/service.py - REM Maintenance → Context Sources: loads sources
connectonion/rem/service.py - REM Maintenance → Mail Archive: archives mail
connectonion/rem/service.py - REM Maintenance → Investigation: supports investigation
connectonion/rem/service.py - REM Maintenance → Project Pages: maintains pages
- User → REM Commands: manages context