# connectonion

> The Best AI Agent Framework for Agent Collaboration. 

- **URL**: https://www.freshcrate.ai/projects/connectonion
- **Author**: openonion
- **Category**: Frameworks
- **Latest version**: `v0.9.4` (2026-05-16)
- **License**: Apache-2.0
- **Source**: https://github.com/openonion/connectonion
- **Homepage**: https://docs.connectonion.com
- **Language**: Python
- **GitHub**: 863 stars, 117 forks
- **Registry**: github (`openonion/connectonion`)
- **Tags**: `agent`, `agentic-ai`, `llm`, `openonion`, `python`

## Description

The Best AI Agent Framework for Agent Collaboration.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.9.4` | 2026-05-16 | High | # Release v0.9.4  ## Highlights  This patch release lands the new `co sub` subscription workflow, makes agent announce publishing durable across restarts, and drops the unused `litellm` dependency for noticeably leaner installs.  ## What's Changed  ### ✨ Features - **`co sub` command** — relationship-based skill subscription, letting agents follow other published bundles - **Durable agent announce publishing** — announce state survives process restarts - **Announce all skills, gate only bodies o |
| `v0.9.3` | 2026-05-08 | High | # Release v0.9.3  Patch release: relay session routing fix and internal documentation polish. No user-facing API changes.  ## What's Changed  ### 🐛 Bug Fixes - **Relay**: `_relay_sid` proxy sessions are now routed via the local `/ws` loopback so a relay-resumed websocket reaches the same hosted agent it was connected to before. ([#134](https://github.com/openonion/connectonion/pull/134))  ### 📚 Documentation - Added rich `LLM-Note` headers to 12 internal modules so AI tooling and new contribut |
| `v0.9.1` | 2026-04-16 | High | ## Bug Fixes  - **Fix `host(agent)` crash on deployed agents** — `host()` now accepts an `Agent` instance directly (wraps it in a factory with a warning). Previously, deployed agents using `host(agent, trust="strict")` crashed immediately with `TypeError: 'Agent' object is not callable`. - **Remove dead `import jwt` from `co status`** — unused import leftover from a refactor, now cleaned up.  ## Migration  If you see this warning after upgrading: ``` Warning: host(agent) — pass a factory functio |
| `v0.8.9` | 2026-04-01 | Medium | ## What's Changed  ### New Features - **cc_prompt template**: Added 250 system prompt reference files to `co copy` - run `co copy cc_prompt` to get the full collection organized by category (system, agents, tools, skills, reminders, data) - **Browser tools**: Added hover, mouse_click, right_click, double_click actions - **Browser tools**: Added ambiguous element detection for smarter element finding - **Browser tools**: Added get_system_info for platform-aware keyboard shortcuts  ### Improvement |
| `v0.8.8` | 2026-03-24 | Medium | ## What's Changed  - **Shadow DOM support** for browser element extraction — fixes LinkedIn modal interactions - **Contenteditable detection** — `contenteditable="true"` elements now detected as interactive - **Post-click DOM wait** — 1s wait after clicks for modals to render - **Coordinate-based clicking for shadow DOM** elements  ### Root Cause  LinkedIn renders its post modal inside a Shadow DOM. `document.querySelectorAll('*')` cannot pierce shadow boundaries. The fix traverses all open shad |
| `v0.8.7` | 2026-03-24 | Medium | ## What's Changed  - **Change `co ai` default model** to `co/gemini-3-flash-preview` (from `co/claude-opus-4-5`) for better price-performance - **Add `gemini-3.1-flash-lite-preview` model support** in oo-api with pricing and documentation  ## Installation  ```bash pip install --upgrade connectonion ```  **Full Changelog**: https://github.com/openonion/connectonion/compare/v0.8.6...v0.8.7 |
| `v0.8.6` | 2026-03-23 | Medium | ## What's Changed  - **System prompt reduced 53%** — workflow, ConnectOnion index, and examples now load on-demand via intent detection (`is_build: true`) instead of being baked into the base prompt (25k → 12k chars) - **Browser tools added to co ai** — `BrowserAutomation` + `image_result_formatter` plugin (44 tools total) - **Lazy browser init** — browser no longer auto-launches on construction, fixing async compatibility with uvicorn server - **Updated `co copy` command** — improved copy comma |
| `v0.8.5` | 2026-03-22 | Low | ## Highlights  WebSocket protocol refactored with CONNECT/INPUT split for cleaner auth flow. Skills plugin now discovers Claude Code skills alongside ConnectOnion skills. Bash permission matching validates full subcommands with fnmatch patterns.  ## What's Changed  ### Protocol - WebSocket protocol: split INIT into CONNECT (auth) + INPUT (prompt) for cleaner separation - Connect client updated for CONNECT → CONNECTED → INPUT handshake - Session registry lifecycle: `executing` → `connected` → `su |
| `v0.8.4` | 2026-03-20 | Low | ## What's Changed  - Add session checkpoint for approval wait recovery - Add command field to tool_blocked event for UI display - Fix test pollution and update tests for current API - Simplify session cleanup to 10min idle for all non-running sessions - Rename useAgent to useAgentForHuman in docs - Update README with non-obvious advantages  ## Installation  ```bash pip install connectonion==0.8.4 ```  **Full Changelog**: https://github.com/openonion/connectonion/compare/v0.8.3...v0.8.4 |
| `v0.8.3` | 2026-03-13 | Low | # Release v0.8.3  ## Highlights  This patch release adds **multimodal input support** (images and files) and completes the **unified permissions system** refactoring. The tool approval plugin now has comprehensive documentation and modular architecture, making it easier to configure and extend.  ## What's Changed  ### ✨ Features - **Multimodal Input Support** (PR-116): `Agent.input()` now accepts `images` and `files` parameters - File upload API with size limits and validation - Images and files |

## Citation

- HTML: https://www.freshcrate.ai/projects/connectonion
- Markdown: https://www.freshcrate.ai/projects/connectonion.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/connectonion/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._