# Markdown workflow for Codex on macOS

Use Markdown files as the handoff surface for plans, acceptance criteria, reports, and instructions. Downright renders them locally, supports Source Focus, and reviews external rewrites.

```bash
down plan.md
down read --json README.md
down outline --json AGENTS.md
```