ship.md monitors folder activities and converts filesystem events like drag, mv, or agent actions into courier dispatches with full audit trails.
Folders represent locations (e.g., home, office) and nested paths preserve semantic context; files in folders are considered at those locations.
A markdown manifest defines inventory, contacts, location, and webhooks for each folder, enabling automated notifications and real-world deliveries on matching events.
The system works with macOS apps, terminal commands, and AI agents, turning file movements into tracked deliveries with SQLite logs for visibility.
Webhooks can be customized per folder, templating context (e.g., location, inventory) into API calls for providers like Uber, with tokens interpolated at dispatch.