---
title: "punaro"
description: "Safely receive and reply to durable Punaro messages and handle explicitly authorized trusted attachments."
canonical: https://agentpluginsdirectory.com/plugins/punaro
last-updated: 2026-09-26
---

# punaro
Safely receive and reply to durable Punaro messages and handle explicitly authorized trusted attachments.
- Slug: punaro
- Publisher: Punaro contributors
- Repository: https://github.com/rock3r/punaro
- Manifest: plugin.json
- Version: 0.1.0-alpha.13
- License: MIT
- Category (editorial): integrations
- Skills: 3 (punaro-attachment, punaro-mailbox, punaro-reply)
- MCP servers: 2 (waypost, waypost-windows)
- Stars: 3
- Repository created: 2026-07-13
- Repository last pushed: 2026-09-25
- Publisher type: User
- Listing: https://agentpluginsdirectory.com/plugins/punaro
- Schema: https://agent-plugins.org/schemas/1.0.0/plugin.schema.json

## What punaro does, in the publisher's words

Punaro is a self-hosted relay for durable conversations between coding agents across multiple computers, with an optional Telegram gateway for a human operator.

It also contains Canopi, an independently deployable "what are my agents doing?" surface (lifecycle events, multi-machine state, 800x480 monochrome render, coding-agent adapters, simulator, and e-paper firmware). Canopi's event protocol does not depend on Punaro transport. See the Canopi guide.

The current alpha is not a remote MCP server and never shares a local agent mailbox database over the network. A local adapter on each machine talks to its own mailbox and to the central relay.

From the project README, punctuation lightly normalized. Full text: https://raw.githubusercontent.com/rock3r/punaro/HEAD/README.md

## Skills

- punaro-attachment: Safely send, receive, or delete one explicitly authorized artifact through the native trusted-attachment client. Use only with operator-provisioned trusted origin, device credential, project, and download root.
- punaro-mailbox: Receive and safely handle messages delivered through a local Punaro-connected Waypost mailbox, including rolling compatibility with legacy agent-mailbox installations. Use when an agent must await incoming mail, inspect a Punaro typed envelope, acknowledge a completed delivery, or diagnose a local…
- punaro-reply: Reply to a message delivered through Punaro or a local Waypost mailbox using the conversation ID in its typed envelope. Use when an agent receives application/vnd.punaro.message+json, a user asks for a reply through an existing Punaro conversation, or a Telegram-routed agent request needs a durable…

Descriptions come from the frontmatter of each SKILL.md, punctuation lightly normalized.

## MCP servers

- waypost: transport: stdio; command: ./scripts/punaro-plugin-mcp
- waypost-windows: transport: stdio; command: ./scripts/punaro-plugin-mcp.cmd

Read from the plugin's own mcp.json. Environment variable names only, never values.
