Repolode
Submit
chekusu

chekusu/yobiru

A Tailscale-based communication layer that lets personal AI agents on your machines send messages, structured data, files, and wake-up requests to each other.

View on GitHub
Stars
290
Forks
40
Open issues
9
Last commit
yesterday

What is it?

Yobiru connects personal agents running on your own computers and cloud workspaces over Tailscale. An agent can address another as host/agent, send text, JSON or files, reply with results, and request a wake-up. Each agent keeps its own interface; Yobiru only supplies the messaging layer underneath.

Each receiver listens on its Tailscale address, verifies the sender's machine identity through tailscale whois, checks a local access policy, and stores accepted messages in a local inbox. Attachments stay on the sender and are fetched by the recipient over Tailscale, with size and SHA-256 verification. Yobiru runs no central messaging or storage service and needs no account.

Tracked requests return a receipt, progress updates and a final outcome, with a deadline after which the result is marked unknown. The package includes seven skills and a Python CLI, with manifests for Codex and Cursor and setup guidance for Grok Bot.

Key features

  • 01Send messages and reply between agents addressed as host/agent over Tailscale.
  • 02Exchange text, JSON, reports, logs and other files with size and SHA-256 checks.
  • 03Track requests with receipts, progress states and a deadline-based timeout.
  • 04Let the receiver decide which senders may wake an agent, with quiet hours and rate limits.
  • 05Keep messages and attachments on your own machines without a central service.

Use cases

  • Asking a research agent on one machine to send findings to a coding agent on another.
  • Passing generated briefs, logs or reports between personal agents without copy-pasting.
  • Letting a cloud agent workspace reach agents on your home computers over a private network.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/chekusu/yobiru.git
  2. 2

    Check the setup with the read-only doctor command

    sh "$Y" doctor
  3. 3

    Name your agent on this machine (preview, then apply with --apply)

    sh "$Y" setup --agent codex --self-agent codex --default-agent codex --apply
  4. 4

    Keep a receiver running in a terminal on each machine

    sh "$Y" serve

Things to know

  • Requires Tailscale installed and signed in on each machine, with a permitted tailnet.
  • The receiver must stay running on each machine, and cloud agents without a shell or persistent receiver cannot use it as-is.
  • Native marketplace installation for Grok Bot and ChatGPT desktop still needs separate verification.

Topics

#ai-agents#tailscale#peer-to-peer#messaging#cli#python#file-transfer#codex

FAQ

What is yobiru?
A Tailscale-based communication layer that lets personal AI agents on your machines send messages, structured data, files, and wake-up requests to each other. Yobiru connects personal agents running on your own computers and cloud workspaces over Tailscale. An agent can address another as host/agent, send text, JSON or files, reply with results, and request a wake-up. Each agent keeps its own interface; Yobiru only supplies the messaging layer underneath.
Is yobiru free to use? What license does it have?
yobiru is open source under the MIT license. Check the license terms before using it in commercial products.
Is yobiru still maintained?
Actively maintained. The last commit to yobiru was on Oct 19, 2026.
What can I use yobiru for?
Asking a research agent on one machine to send findings to a coding agent on another. Passing generated briefs, logs or reports between personal agents without copy-pasting. Letting a cloud agent workspace reach agents on your home computers over a private network.
How do I install yobiru?
Clone the repository: git clone https://github.com/chekusu/yobiru.git Check the setup with the read-only doctor command: sh "$Y" doctor Name your agent on this machine (preview, then apply with --apply): sh "$Y" setup --agent codex --self-agent codex --default-agent codex --apply Keep a receiver running in a terminal on each machine: sh "$Y" serve
Where can I get yobiru?
The source code and installation instructions are on GitHub: https://github.com/chekusu/yobiru

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects