agent-inbox

Sends, lists, reads, and acknowledges messages between projects via a local JSON inbox.

1|Updated Nov 12, 2025
One-click install
npx skills add https://github.com/grahama1970/fetcher --skill agent-inbox-grahama1970
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-inbox
Source: https://github.com/grahama1970/fetcher/tree/main/.agents/skills/agent-inbox
Command: npx skills add https://github.com/grahama1970/fetcher --skill agent-inbox-grahama1970

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

File-based inter-agent messaging that lets different projects exchange bugs, requests, and status updates without manual copy-paste. It provides a simple registry of registered projects, a minimal CLI wrapper, and a Python API for automation.

Core Features & Use Cases

  • Message sending/receiving across projects
  • Local inbox with pending/done states and simple search
  • Easy integration with CLIs and scripts for automation and hooks
  • Use Case: Coordinate bug reports between teams or agent projects with minimal setup.

Quick Start

Register projects with the agent-inbox tool and start sending a test message to verify the workflow.

Frequently Asked Questions about agent-inbox

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

FAQPage Schema
How do I set up cross-project communication between AI agents?

Cross-project communication between AI agents is set up by registering projects with a file-based inbox system. This allows agents to exchange bugs, requests, and status updates locally without manual copy-paste.

What is a file-based inter-agent messaging inbox and how does it work?

A file-based inter-agent messaging inbox stores messages as JSON files under a local directory like ~/.agent-inbox. It provides pending and done states, enabling local agents to send, list, read, and acknowledge messages.

Can I automate inter-agent messaging using a Python API and CLI wrapper?

Yes, you can automate inter-agent messaging by integrating a lightweight Python API and a minimal CLI wrapper into your automation scripts and hooks. This enables programmatic sending and receiving of messages between registered projects.

How do I register projects for local agent messaging?

You register projects for local agent messaging by adding them to a simple project registry using the agent-inbox tool. Once registered, projects can immediately start sending test messages to verify the workflow.

Does the agent-inbox tool require external dependencies or servers to run?

No, the agent-inbox tool runs entirely locally and requires no external dependencies or servers. It stores all inter-agent messages as JSON files in a local directory, making it a portable cross-project communication solution.

What are the limitations of file-based messaging for AI agent coordination?

File-based messaging for AI agent coordination relies on a local JSON storage directory under ~/.agent-inbox, meaning it is best suited for local cross-project automation rather than distributed, remote, or large-scale multi-server environments.