connectonion-studio 0.1.2

ConnectOnion Studio — local test cockpit for ConnectOnion agents: create, run, QR, live logs, Copy-for-Claude diagnostics.

A local test cockpit for ConnectOnion agents.

Click toolkits to build an agent · scan its QR from the iOS app · watch live logs

---

Install

pipx install connectonion-studio      # or: pip install connectonion-studio
co-studio                             # opens http://127.0.0.1:9900

That's it. The first launch auto-creates your identity and activates your managed model key (needs internet — it's your own key, one per user). Offline on first run? Just run co auth once you're back online.

Desktop app (macOS)

A native macOS app (SwiftUI + WKWebView) lives in macos/ — the same cockpit in a real window with the traffic-light chrome and app icon. Build and run it from Xcode (macos/ConnectOnionStudio/); a signed .dmg for one-click install is on the way.

What it does

🧩 Create	Form: name · model · toolkit checkboxes → identity + QR ready instantly
▶️ Run	One process per agent, health-polled every 5 s, live state over WebSocket
📱 QR	Bare 0x address — scan it in the iOS "Add agent" flow
📜 Logs	Live stdout + framework-logger streams, per agent
🩺 Copy for Claude	Paste-ready markdown diagnostics bundle, one click
🗑️ Delete	Two-step confirm, then a permanent delete — identity, keys, and logs are removed for good

Toolkits: utility · web · files · shell (approval-gated) · image

Requirements

Python 3.11+ · macOS, Linux, or Windows (WSL recommended)

API reference

Method	Path	Returns
GET	/api/agents	{"agents": [AgentSummary]}
POST	/api/agents	AgentDetail — body {name, model, toolkits, trust}
GET	/api/agents/{slug}	AgentDetail
POST	/api/agents/{slug}/start · /stop · /restart	{"state": …}
POST	/api/agents/{slug}/rename	AgentSummary — body {name}
DELETE	/api/agents/{slug}	204 (stops the agent, then permanently deletes it)
GET	/api/agents/{slug}/qr.svg	SVG QR
GET	/api/agents/{slug}/diagnostics	Markdown bundle
GET	/api/setup/status	Doctor checks
WS	/ws/status	Status frames (each change + every 5 s)
WS	/ws/agents/{slug}/logs	{"source": "stdout" | "logger", "line": …}

Storage & internals

~/.co-studio/agents/<slug>/   meta.json · agent.py · .env · .co/ · studio-stdout.log

• Agent ports 8000–8099, allocated by socket probe (busy ports skipped, re-probed at start).
• agent.py is standalone — eject it anywhere and python agent.py still works (the announce IP-trim patch is inlined).

Development (from source)

git clone https://github.com/EvanYifanYang/connectonion-studio && cd connectonion-studio
./install.sh
.venv/bin/co-studio

Env	Effect
CONNECTONION_PATH=~/repo/connectonion ./install.sh	Install the framework from a local checkout instead of PyPI
PYTHON=python3.12 ./install.sh	Pick the interpreter

Security

• The manager binds 127.0.0.1:9900 only.
• Agent ports are unauthenticated and exposed on your LAN by host() — that is how the phone connects. Don't run on hostile networks.