MCP Agent Mail — Shared Mailbox Snapshot

This repository hosts a static export of an MCP Agent Mail project. It contains a scrubbed SQLite snapshot plus a self-contained viewer so teammates can browse threads, attachments, and metadata without needing direct database access.

What's Included

• mailbox.sqlite3 — scrubbed mailbox database (agent names retained, ack/read state cleared).
• viewer/ — static web viewer (Alpine.js + Tailwind) with inbox, thread explorer, search, and attachment tooling.
• manifest.json — machine-readable metadata (project scope, scrub stats, hosting hints, asset SRI hashes).
• _headers — COOP/COEP headers for hosts that support Netlify-style header rules.
• .nojekyll — disables GitHub Pages' Jekyll processing so _headers and .wasm assets are served untouched.
• HOW_TO_DEPLOY.md — detailed deployment checklist for GitHub Pages, Cloudflare Pages, Netlify, or generic hosts.

Live Viewer

The viewer/index.html application renders the exported mailbox locally or when deployed to static hosting. If this repo is published via GitHub Pages, the root index.html immediately redirects to the viewer.

Detected hosting signals when this export was generated:

• GitHub Pages — Deploy the bundle via docs/ or gh-pages branch with coi-serviceworker.js for cross-origin isolation. (signals: Git remote: https://github.com/Dicklesworthstone/mcp_agent_mail.git)

Quick Start

1. Install dependencies (first time only):

   uv sync

2. Rebuild or update the export from the source project:

   uv run python -m mcp_agent_mail.cli share update /path/to/this/repo

3. Preview locally:

   uv run python -m mcp_agent_mail.cli share preview .

   The command serves the viewer at http://127.0.0.1:9000/ with hot reload.
4. Deploy using GitHub Pages (built into the share wizard) or manually follow HOW_TO_DEPLOY.md.

Regenerating a Fresh Snapshot

From the MCP Agent Mail source checkout, run:

uv run python -m mcp_agent_mail.cli share export \
  --output /path/to/this/repo \
  --project <project-slug> \
  --scrub-preset standard \
  --no-zip

This overwrites the bundle (after you clean the repo) with the latest messages while preserving viewer assets.

Verifying Integrity

• Signed bundles: If manifest.sig.json is present, verify with:

  uv run python -m mcp_agent_mail.cli share verify . --public-key $(cat signing-*.pub)

• SRI hashes: manifest.json records SHA256 digests for viewer assets; static hosts can pin hashes if desired.

Troubleshooting

• GitHub Pages shows 404: confirm Pages is set to the main branch and root (/). The wizard calls gh api repos/:owner/:repo/pages automatically; re-run it if needed.
• .wasm served as text/plain: ensure .nojekyll is present and _headers are respected, or configure MIME types manually.
• Viewer warns about OPFS: host must send COOP/COEP headers. GitHub Pages requires the bundled coi-serviceworker.js to be uncommented (see HOW_TO_DEPLOY.md).

About MCP Agent Mail

MCP Agent Mail is an asynchronous coordination layer for multi-agent coding workflows. It captures messages, attachments, and advisory file reservations so agents can collaborate safely. Static exports make it easy to share audit trails without granting direct database access.