Verified:GitHub

agent-mailbox

Coordinates multi-agent task claiming and peer messaging through file-based mailboxes.

Updated Jan 19, 2023

Search Tags:#messaging #workflow #multi-agent #coordination #file-based #task claiming #peer exchange

One-click install

npx skills add https://github.com/inkfin/dotfiles --skill agent-mailbox-inkfin

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: agent-mailbox
Source: https://github.com/inkfin/dotfiles/tree/main/dot_agents/skills/exact_agent-mailbox
Command: npx skills add https://github.com/inkfin/dotfiles --skill agent-mailbox-inkfin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When multiple AI agents work in parallel on a shared goal, they need a way to claim tasks without duplication and exchange findings mid-flight without a central server. This Skill provides a file-based coordination protocol under ~/.cache/agents-supervisor so peer agents can claim work and message each other using only atomic file renames. ## Core Features & Use Cases - Atomic Task Claiming: Agents list pending tasks and claim them by renaming files from --pending to --claimed--<agent>, preventing double-assignment through filesystem atomicity. - Peer Inbox Messaging: Agents send short messages by writing new files to inbox/to-<peer>--from-<you>--<slug>.md, never editing another agent's files. - Shared Knowledge Space: Long findings and consensus go into a shared/ directory so messages stay short and reference paths instead. - Use Case: A lead agent spawns three workers to debate an authentication design. Each worker claims sub-tasks from the team's tasks/ directory, exchanges critiques via inbox files, and writes the final consensus to shared/ before reporting back to the lead. ## Quick Start Set up a team mailbox under ~/.cache/agents-supervisor for my worker agents so they can claim tasks and message each other during this multi-agent run.

Frequently Asked Questions about agent-mailbox

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do agents avoid conflicts when claiming the same task?▼

Claims rely on atomic filesystem renames, so only one agent can successfully rename a pending file. An agent whose rename fails simply moves on to another pending task instead of retrying the same one.