Markdown workflow for Codex on macOS

Codex can inspect and change repository files. A native Markdown viewer makes the surrounding plans, instructions, reports, and README files readable while the work is happening.

Use files as the handoff surface

Keep implementation plans, acceptance criteria, test results, and remaining blockers in Markdown. Open the file in Downright and use its rendered view for reading, Source Focus for exact syntax, and the outline for navigation.

See what changed

If Codex rewrites an open document, Downright shows the external update instead of treating it as an unexplained refresh. Review the changed words, then choose the version that should become the file's source.

Useful commands

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

The CLI and the app operate on the same local Markdown files. No account or cloud workspace is required.