email-via-filesystem

Community

Move agent mail through the filesystem mailbox.

Authorigamenovoer
Version1.0.0
Installs0

System Documentation

What problem does it solve?

It eliminates the complexity of coordinating async, email-like message exchange for agents when mailbox state and messages must live on disk with SQLite-backed tracking and lock synchronization.

Core Features & Use Cases

  • Filesystem-backed async mailbox transport: Read, send, reply to, and inspect mailbox messages stored as Markdown files under a runtime-provided mailbox root.
  • Thread-accurate conversation handling: Preserve stored thread ancestry using persisted thread_id and in_reply_to semantics rather than subject-based heuristics.
  • Safe shared-mailbox operations: Use mailbox-local rules and managed helper scripts for sensitive operations touching index.sqlite or locks, following required env bindings and initialization guards.
  • Projection-based message delivery: Maintain canonical immutable message bodies under messages/<YYYY-MM-DD>/..., while inbox/sent entries are symlink projections to those canonical files.

Quick Start

Use email-via-filesystem to have an agent read unread messages and send a reply using the runtime-provided filesystem mailbox bindings.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: email-via-filesystem
Download link: https://github.com/igamenovoer/houmao/archive/main.zip#email-via-filesystem

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.