oo

🧅 oo

---

oo is the official companion skill for the ConnectOnion framework. Install it in your AI coding agent, then talk to any remote ConnectOnion agent through natural language — delegate tasks, collaborate across agents, get results back.

You: /oo 0x3d4017c3e843895a92b70aa74d1b7ebc9c982... translate this doc to English

Agent: Connecting to remote agent...
       CO_METHOD: direct
       [Returns translated document]

🚀 Quick Start

Prerequisites

• Python 3.10+
• pip install connectonion
• Agent identity: run co init in your project or home directory

Installation

One-liner (recommended) — installs into every detected agent:

curl -fsSL agent.openonion.ai/install | sh

(Or pipe to python3 - if you'd rather skip the shell shim and run install.py directly. Works on macOS, Linux, Windows — needs python3 + git.)

The installer clones this repo to ~/.connectonion/bundles/oo, then drops the bundled skills into whichever coding agents are present:

• Claude Code → ~/.claude/plugins/oo/ (whole bundle as a plugin, auto-namespaced)
• Codex CLI → ~/.codex/skills/oo-<skill>/ (symlinks per skill)
• OpenClaw → ~/.openclaw/skills/oo-<skill>/ (symlinks per skill)
• Cursor → ~/.cursor/rules/oo-<skill>.mdc (frontmatter converted)
• Kiro → ~/.kiro/steering/oo-<skill>.md (plain copies)

To uninstall: curl -fsSL agent.openonion.ai/install | sh -s -- --uninstall

There is no oo CLI to install — everything is a SKILL.md. Your coding agent runs the skill; the skill calls the connectonion Python library directly. The bundle ships with five skills:

• oo — connect to a remote agent and delegate a task (/oo 0x... <task>).
• oo-init — scaffold a new bundle (agent.json + skill dirs).
• oo-publish — sign agent.json and ANNOUNCE it over the relay.
• oo-subscribe — request a follow + mirror a publisher's bundle.
• oo-accept — review and accept incoming subscription requests.

Manual install per tool — if you'd rather not run the installer, copy skills/<name>/SKILL.md directly into your agent's skill directory. Claude Code, Codex, and OpenClaw all read the canonical SKILL.md format. Cursor and Kiro need format conversion — see install.py for the exact transformation.

💬 Usage

With agent address