# openonion/connectonion architecture

> Architecture diagram of the GitHub repository openonion/connectonion, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/openonion/connectonion
- Repository: https://github.com/openonion/connectonion

## Overview

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: [`connectonion/rem/service.py`](https://github.com/openonion/connectonion/blob/main/connectonion/rem/service.py) (REM Maintenance), [`connectonion/cli/main.py`](https://github.com/openonion/connectonion/blob/main/connectonion/cli/main.py) (`co` CLI), [`connectonion/network/host/server.py`](https://github.com/openonion/connectonion/blob/main/connectonion/network/host/server.py) (Agent Host), [`connectonion/cli/commands/rem_commands.py`](https://github.com/openonion/connectonion/blob/main/connectonion/cli/commands/rem_commands.py) (REM Commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI and Identity"]
  node_cli["&#96;co&#96; CLI<br/>[main.py]"]
  node_identity["Agent Identity<br/>[address.py]"]
  node_environment["Environment Config<br/>[environment.py]"]
  node_coding_cli["Coding Agent CLI<br/>[main.py]"]
end

subgraph group_agents["Agent Runtime"]
  node_agent["Agent Loop<br/>[agent.py]"]
  node_llm["Model Providers<br/>[llm.py]"]
  node_tools["Tool Execution<br/>[tool_executor.py]"]
  node_usage["Usage and Costs<br/>[usage.py]"]
end

subgraph group_hosting["Hosting and Network"]
  node_host["Agent Host<br/>[server.py]"]
  node_host_auth["Host Authentication<br/>[auth.py]"]
  node_sessions[("Hosted Sessions<br/>[storage.py]")]
end

subgraph group_rem["Context and REM"]
  node_rem_cli["REM Commands<br/>[rem_commands.py]"]
  node_rem_service["REM Maintenance<br/>[service.py]"]
  node_rem_sources["Context Sources<br/>[source.py]"]
  node_rem_store[("Local Notebook<br/>[files.py]")]
  node_investigation["Investigation<br/>[investigate.py]"]
  node_project_pages["Project Pages<br/>[project_pages.py]"]
  node_mail_archive[("Mail Archive<br/>[mail_archive.py]")]
end

subgraph group_integrations["Tools and Integrations"]
  node_browser["Browser Agent<br/>[client.py]"]
  node_tool_catalog["Account and Web Tools"]
  node_inbox["Chat Inboxes"]
end

node_user(("User"))

node_user -->|"runs commands"| node_cli
node_cli -->|"sets up identity"| node_identity
node_cli -->|"loads settings"| node_environment
node_cli -->|"dispatches REM"| node_rem_cli
node_user -->|"starts agent"| node_coding_cli
node_coding_cli -.->|"hosts agent"| node_host
node_agent -->|"requests completions"| node_llm
node_agent -->|"executes tools"| node_tools
node_llm -->|"records usage"| node_usage
node_host -->|"uses authentication"| node_host_auth
node_host -->|"persists sessions"| node_sessions
node_user -.->|"connects accounts"| node_tool_catalog
node_user -.->|"uses browser"| node_browser
node_user -.->|"uses chat apps"| node_inbox
node_rem_cli -->|"runs maintenance"| node_rem_service
node_rem_service -->|"reads and writes"| node_rem_store
node_rem_service -->|"loads sources"| node_rem_sources
node_rem_service -->|"archives mail"| node_mail_archive
node_rem_service -->|"supports investigation"| node_investigation
node_rem_service -.->|"maintains pages"| node_project_pages
node_user -->|"manages context"| node_rem_cli

click node_cli "https://github.com/openonion/connectonion/blob/main/connectonion/cli/main.py"
click node_identity "https://github.com/openonion/connectonion/blob/main/connectonion/address.py"
click node_environment "https://github.com/openonion/connectonion/blob/main/connectonion/environment.py"
click node_coding_cli "https://github.com/openonion/connectonion/blob/main/connectonion/cli/co_ai/main.py"
click node_agent "https://github.com/openonion/connectonion/blob/main/connectonion/core/agent.py"
click node_llm "https://github.com/openonion/connectonion/blob/main/connectonion/core/llm.py"
click node_tools "https://github.com/openonion/connectonion/blob/main/connectonion/core/tool_executor.py"
click node_usage "https://github.com/openonion/connectonion/blob/main/connectonion/core/usage.py"
click node_host "https://github.com/openonion/connectonion/blob/main/connectonion/network/host/server.py"
click node_host_auth "https://github.com/openonion/connectonion/blob/main/connectonion/network/host/auth.py"
click node_sessions "https://github.com/openonion/connectonion/blob/main/connectonion/network/host/session/storage.py"
click node_browser "https://github.com/openonion/connectonion/blob/main/connectonion/cli/browser_agent/client.py"
click node_tool_catalog "https://github.com/openonion/connectonion/tree/main/connectonion/useful_tools"
click node_inbox "https://github.com/openonion/connectonion/tree/main/connectonion/inbox"
click node_rem_cli "https://github.com/openonion/connectonion/blob/main/connectonion/cli/commands/rem_commands.py"
click node_rem_service "https://github.com/openonion/connectonion/blob/main/connectonion/rem/service.py"
click node_rem_sources "https://github.com/openonion/connectonion/blob/main/connectonion/rem/source.py"
click node_rem_store "https://github.com/openonion/connectonion/blob/main/connectonion/rem/files.py"
click node_investigation "https://github.com/openonion/connectonion/blob/main/connectonion/rem/investigate.py"
click node_project_pages "https://github.com/openonion/connectonion/blob/main/connectonion/rem/project_pages.py"
click node_mail_archive "https://github.com/openonion/connectonion/blob/main/connectonion/rem/mail_archive.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_identity,node_environment,node_coding_cli,node_user toneBlue
class node_agent,node_llm,node_tools,node_usage toneAmber
class node_host,node_host_auth,node_sessions toneMint
class node_rem_cli,node_rem_service,node_rem_sources,node_rem_store,node_investigation,node_project_pages,node_mail_archive toneRose
class node_browser,node_tool_catalog,node_inbox toneIndigo
```

## Components

### CLI and Identity

- [`co` CLI](https://github.com/openonion/connectonion/blob/main/connectonion/cli/main.py): `connectonion/cli/main.py`
- [Agent Identity](https://github.com/openonion/connectonion/blob/main/connectonion/address.py): `connectonion/address.py`
- [Environment Config](https://github.com/openonion/connectonion/blob/main/connectonion/environment.py): `connectonion/environment.py`
- [Coding Agent CLI](https://github.com/openonion/connectonion/blob/main/connectonion/cli/co_ai/main.py): `connectonion/cli/co_ai/main.py`

### Agent Runtime

- [Agent Loop](https://github.com/openonion/connectonion/blob/main/connectonion/core/agent.py): `connectonion/core/agent.py`
- [Model Providers](https://github.com/openonion/connectonion/blob/main/connectonion/core/llm.py): `connectonion/core/llm.py`
- [Tool Execution](https://github.com/openonion/connectonion/blob/main/connectonion/core/tool_executor.py): `connectonion/core/tool_executor.py`
- [Usage and Costs](https://github.com/openonion/connectonion/blob/main/connectonion/core/usage.py): `connectonion/core/usage.py`

### Hosting and Network

- [Agent Host](https://github.com/openonion/connectonion/blob/main/connectonion/network/host/server.py): `connectonion/network/host/server.py`
- [Host Authentication](https://github.com/openonion/connectonion/blob/main/connectonion/network/host/auth.py): `connectonion/network/host/auth.py`
- [Hosted Sessions](https://github.com/openonion/connectonion/blob/main/connectonion/network/host/session/storage.py): `connectonion/network/host/session/storage.py`

### Context and REM

- [REM Commands](https://github.com/openonion/connectonion/blob/main/connectonion/cli/commands/rem_commands.py): `connectonion/cli/commands/rem_commands.py`
- [REM Maintenance](https://github.com/openonion/connectonion/blob/main/connectonion/rem/service.py): `connectonion/rem/service.py`
- [Context Sources](https://github.com/openonion/connectonion/blob/main/connectonion/rem/source.py): `connectonion/rem/source.py`
- [Local Notebook](https://github.com/openonion/connectonion/blob/main/connectonion/rem/files.py): `connectonion/rem/files.py`
- [Investigation](https://github.com/openonion/connectonion/blob/main/connectonion/rem/investigate.py): `connectonion/rem/investigate.py`
- [Project Pages](https://github.com/openonion/connectonion/blob/main/connectonion/rem/project_pages.py): `connectonion/rem/project_pages.py`
- [Mail Archive](https://github.com/openonion/connectonion/blob/main/connectonion/rem/mail_archive.py): `connectonion/rem/mail_archive.py`

### Tools and Integrations

- [Browser Agent](https://github.com/openonion/connectonion/blob/main/connectonion/cli/browser_agent/client.py): `connectonion/cli/browser_agent/client.py`
- [Account and Web Tools](https://github.com/openonion/connectonion/tree/main/connectonion/useful_tools): `connectonion/useful_tools`
- [Chat Inboxes](https://github.com/openonion/connectonion/tree/main/connectonion/inbox): `connectonion/inbox`

### Other components

- **User**

## Connections

- User → `co` CLI: runs commands
- `co` CLI → Agent Identity: sets up identity (evidence: `connectonion/cli/main.py`)
- `co` CLI → Environment Config: loads settings (evidence: `connectonion/cli/main.py`)
- `co` CLI → REM Commands: dispatches REM (evidence: `connectonion/cli/main.py`)
- User → Coding Agent CLI: starts agent
- Coding Agent CLI → Agent Host: hosts agent
- Agent Loop → Model Providers: requests completions (evidence: `connectonion/core/agent.py`)
- Agent Loop → Tool Execution: executes tools (evidence: `connectonion/core/agent.py`)
- Model Providers → Usage and Costs: records usage (evidence: `connectonion/core/llm.py`)
- Agent Host → Host Authentication: uses authentication (evidence: `connectonion/network/host/server.py`)
- Agent Host → Hosted Sessions: persists sessions (evidence: `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 (evidence: `connectonion/rem/service.py`)
- REM Maintenance → Context Sources: loads sources (evidence: `connectonion/rem/service.py`)
- REM Maintenance → Mail Archive: archives mail (evidence: `connectonion/rem/service.py`)
- REM Maintenance → Investigation: supports investigation (evidence: `connectonion/rem/service.py`)
- REM Maintenance → Project Pages: maintains pages
- User → REM Commands: manages context
