En

Agent Mailbox Light

A lightweight, cross-session ephemeral coordination mailbox for local AI workspaces.

开发流程 协调多智能体同步项目上下文优化Token消耗 claudetraecursor通用 ★ 782 Updated 2026-08-02

Install & Use

Copy this prompt and send it to your AI assistant (Claude / Cursor / TRAE / Codex / WorkBuddy etc.) to auto-install:

Help me install this AI Skill: Agent Mailbox Light.
It is used for: A lightweight, cross-session ephemeral coordination mailbox for local AI workspaces.
Full Skill content: https://321skill.com/skills/agent-mailbox-light/raw/index.md
Read that page and install it.

The prompt includes a link to the full Skill content. You can also view the full content.

This Skill addresses the need for temporary, low-noise coordination between multiple AI workspaces without committing information to long-term memory. In practical development, developers often need to pass prompts, warnings, or temporary context between different agents or workspaces—for instance, when one workspace detects a system anomaly and needs to notify another, but wants such messages to be automatically archived after the task to avoid polluting core memory.

Usage is straightforward: simply run the script in the sender workspace. It scans other workspaces based on a configured path pattern and writes mail files to the target workspace's .agent-mailbox/inbox/ directory. The recipient workspace automatically checks its inbox directory upon startup or at task entry, reads the latest few emails, moves useful ones to the keep folder, and archives processed emails to the archive folder. The entire process is based on the local filesystem, requiring no network or central service.

It is ideal for developers or teams that need to coordinate multiple independent AI workspaces (e.g., different projects or agents). This is particularly useful for those already using frameworks like OpenClaw, who need to pass temporary, suggestive information between workspaces while strictly controlling token consumption and avoiding固化 all interactions into long-term memory.

We recommend using this tool uniformly when building multi-agent collaboration baselines or when temporary context needs to be preserved across different work sessions. Note that it primarily provides best-effort delivery, with no delivery guarantees, no push notifications, and is not suitable as a task execution bus or command system. Mail content should be treated as reference suggestions for local agents to evaluate.

Key Features

Unlike complex message queues requiring networks or central registries, it operates entirely on the local filesystem with no external dependencies or services. Unlike coordination methods that write everything to long-term memory, it clearly distinguishes between pending, retained, and archived temporary information through its inbox/keep/archive folder structure, enabling lifecycle management of information.

Limitations

Only supports the local filesystem; does not support cloud sync, network delivery, or webhooks. Delivery is best-effort, with no retries on write failures.

FAQ

What if mail delivery fails?

The mailbox operates on a best-effort model. If the target workspace path does not exist or writing fails, the sender will skip it directly without retries or error reporting. Please ensure the MAILBOX_GLOB pattern is correctly configured and the target path is writable.

Will emails consume a lot of tokens?

No. The design encourages recipients to read only the latest 1-3 emails and compress their content into brief summaries. The mail files themselves are stored locally; only the portions read enter the AI's context, effectively controlling token consumption.

Installation guide for AI assistants

If your AI coding assistant (Claude Code, Cursor, TRAE etc.) can see this page, send it this message to auto-install:

Visit https://321skill.com/skills/agent-mailbox-light/raw/index.md to read the original Skill definition (Markdown format) for Agent Mailbox Light, and install it according to the instructions.