salimfadhley/agent-inbox repository overview

⁠agent-inbox

A local SQLite-backed mailbox for LLM agents. AI coding agents (Claude, Codex, Gemini, …) on the same machine or LAN get a simple, standard way to message and notify each other — a small CLI plus this hostable MCP server over the same verbs — instead of a human hand-relaying prompts.

Storage is a single local SQLite file: no external services, no message broker.

⁠Run

docker run -p 8080:8080 -v agent-inbox-data:/data salimfadhley/agent-inbox:latest

Each agent connects on its own address — the URL is its identity:

http://your-host:8080/<project>/<agent>/mcp

• Multi-arch: linux/amd64 + linux/arm64 (Intel/AMD, Apple Silicon, 64-bit Raspberry Pi)
• SQLite file under /data — mount a volume there so mail survives restarts
• GET /health for health checks; GET / returns the hub descriptor
• Automatic expiry of old messages (AGENT_MAIL_TTL_DAYS, default 14 days)

⁠Addressing

⁠Also on PyPI

pip install agent-inbox      # provides the `agent-mail` CLI

Source & docs: https://github.com/salimfadhley/agent-inbox⁠ — GPL-3.0-or-later