openonion/connectonion

Identity & memory

Mail, calendar & notes

Chat apps

Browser & files

Issues & feedback

Coding agents

Models

Agents & servers

Every command · co commands lists them all.

co rem — decentralized context flow

Your context, connected and ready for the next task. co rem connects context from your mail and coding sessions in local, linked Markdown pages. People, projects, skills and decisions stay connected to their sources, so you and your agents can follow the evidence and reuse that context.

The context lives on your machine, where your tools and agents can read it. Memory keeps it available over time; the goal is to keep context flowing through your work.

Explore co rem → · Try the sample reader · Setup and source controls

The reader’s morning brief with invented example data. The linked sample is a frozen notebook you can explore without connecting an account.

• Connect scattered context. Bring mail and coding sessions into linked pages about the people, projects and skills involved.
• Follow the evidence. Trace facts, decisions and changes back to their sources, then carry that understanding into the next task.
• Keep context in your hands. Local Markdown pages can be read by you and your agents. An approved schedule keeps them current.

Try co rem · 1.9.2

Start with the setup guide for account setup, source choices and model costs. Daily scheduling currently requires macOS. Then run:

pip install --upgrade 'connectonion==1.9.2'
# build your map and first pages; approve nightly upkeep when prompted
co rem init
# read the local notebook
co rem open

Pages stay in ~/.co/rem. Selected source content is sent to the configured model during investigation; see source controls and costs. For access from another device, co rem open --live opens your online co ai Host at https://chat.openonion.ai//rem, for the Host owner only.

Install and start

One line installs co and sets it up: your agent identity, an OpenOnion key with starter credit, and the skills and command index that tell Codex and Claude Code about co.

curl -fsSL https://raw.githubusercontent.com/openonion/connectonion/main/install.sh | sh

It uses uv (installing it if needed) to keep co out of your system Python, so you need no Python of your own. Then connect what you use:

co auth google      # Gmail and Google Calendar
co auth microsoft   # Outlook
co commands         # everything else; add --help to any

The Quick start guide covers Google, the browser, chat apps and project settings.

Your tools, one command line

Use Gmail, Outlook, your browser, files and chat apps from the same co command. Your agent discovers each tool through --help when it needs it.

See the CLI in action

Watch the 43-second film — real runs from co 1.8.10.

Use it from Claude Code, Codex or Cursor

Nothing to install into them: ask your coding agent to “use co to check my Outlook inbox” and it reads co commands and co outlook --help before it acts. co skills link also links ConnectOnion’s skills into Claude Code and Codex (co skills).

ConnectOnion is also a Python framework for building your own agents on the same harness; see the documentation.

Hand a session to someone · 1.9.2

Say “hand this to Bob” in Codex or Claude Code. You see exactly what would leave your machine, with private sentences already taken out by your own agent; Bob pastes one line into his agent, which picks up where yours stopped and sends the result back as a patch. Neither side gets more than the handoff. See openonion/handoff and the guide.

Project

Stable 1.9.2 is what pip install connectonion installs; previews remain opt-in (release channels, release notes). Questions go to Discussions or the Discord linked above, bugs to Issues. Contributing · Code of Conduct · Security (report vulnerabilities privately) · Apache-2.0.