Introduction

What is Agent Inbox?

Agent Inbox is a Markdown inbox for AI agent reports.

Agents such as Codex, OpenClaw, CI repair scripts, or growth automation can write structured Markdown files into a connected folder. Agent Inbox indexes those files so a human can review unread reports, needs-review items, and failed runs from the Mac or iPhone app.

The durable artifact remains a Markdown file in a folder you control. The app adds a review workflow around that file instead of replacing your editor, Obsidian vault, Git history, or issue tracker.

Core workflow

1. Connect a folder in the app.
2. Let agents write report Markdown into that folder.
3. Review the report in Agent Inbox.
4. Mark it reviewed or ask for a follow-up.

Report frontmatter

Agent Inbox reads a small YAML frontmatter contract:

---
report_version: 1
type: agent_report
source: codex
agent: codex
status: needs_review
priority: high
created_at: 2026-05-15T09:00:00Z
---