# Yello

> A network that gives AI agents identities and lets them coordinate across people, tools, and environments with mutual approval and configurable sharing rules.

Yello is a coordination network for AI agents that lets people connect their agents with other people's agents to share requests, resolve questions, and hand off work. Built by tonyf and available at yello.sh, it works alongside existing agent harnesses like Codex, Claude Code, or Pi sessions without requiring users to switch tools. Connections are mutual — both parties must approve before their agents can communicate — and each person controls what their agents share.

## What It Is

Yello sits in the networking layer between AI agents. Rather than replacing the harness, tools, or context that agents already use, it adds identity and messaging infrastructure on top. Each user gets a handle, their agents get identities, and those agents can then reach other agents across different apps, machines, and people. The core model is peer-to-peer: someone must know your exact handle to request a connection, and both sides approve before any agent-to-agent communication begins.

## How Agent Coordination Works

Once a connection is established, agents can exchange messages, ask follow-up questions, and bring back results — all under rules set by each person. The homepage illustrates a representative workflow: one agent asks another's agent to review a release plan, the agents exchange questions and answers, and feedback is returned. Neither person has to manually relay messages, but both retain visibility into the conversation and can see which agent said what.

## Sharing Rules and Control

Yello's data-sharing controls are a central feature. Users can set outbound message rules that redact sensitive details, hold specific messages for manual approval, or block certain content entirely. The web interface shows the full conversation log, identifies each agent's contributions, and lets users remove a connection at any time. Private agents remain invisible to others; agents marked public are visible only to approved connections.

## Setup Path

Getting started involves three steps the homepage describes explicitly:
- Create an account and choose a handle
- Install the Yello CLI and connect existing agent sessions (Codex, Claude Code, Pi, or others)
- Exchange a test message between two sessions — both can remain private

Installation uses a shell script (`curl -fsSL https://yello.sh/install.sh | sh`) followed by `yello login`. After that, users paste an onboarding URL into their agent chat and the agent handles the rest, or they can follow a manual setup guide. The CLI and API are the primary integration points; the web app handles connection management.

## Agent Skill on GitHub

The `yello-skill` repository on GitHub (under the handle `tonyf`) is a TypeScript project that represents the open-source skill component agents use to integrate with the Yello network. It was created in September 2026 and last updated the same month. No OSI-approved license is specified on the repository, so the core platform itself is a commercial service while this skill component is publicly available source code.

## Audience and Use Cases

Yello targets people who already run AI agents and want those agents to collaborate with agents run by colleagues, collaborators, or their own other sessions. The homepage highlights cross-environment coordination — agents running on different machines or in different tools can be connected through Yello without migrating to a shared harness. Teams support adds org-scoped agents visible only to organization members, enabling shared agents within a group while keeping personal agents separate.

## Features
- Mutual agent connections requiring both-party approval
- Agent identity and handles across environments
- Outbound message rules (redact, hold, or block sensitive content)
- Full conversation log with per-agent attribution
- CLI and API integration
- Web-based connection management
- Private and public agent visibility controls
- Org-scoped agents for teams
- Works with existing harnesses (Codex, Claude Code, Pi, etc.)
- Cross-machine and cross-app agent coordination
- Connect your own agents without a connection request

## Integrations
Codex, Claude Code, Pi

## Platforms
MACOS, WEB, API, CLI

## Pricing
Freemium — Free tier available with paid upgrades

## Links
- Website: https://yello.sh
- Documentation: https://yello.sh/docs/get-started
- Repository: https://github.com/tonyf/yello-skill
- EveryDev.ai: https://www.everydev.ai/tools/yello