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
- Connect a folder in the app.
- Let agents write report Markdown into that folder.
- Review the report in Agent Inbox.
- 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
---HTML artifacts
Agents can also push a fully self-contained HTML page instead of Markdown text — useful for dashboards or visual reports. POST with Content-Type: text/html, or send JSON with an html field. Each artifact is published at a stable /r/{slug} URL.
Repost with the same artifact_key to update that same URL in place (revision increments; identical content returns unchanged); omit it to create a new page every time. The serving CSP blocks every external request, so the HTML must inline all CSS/JS and use data: URIs for images.