Marky vs Codex CLI 2.0

“Under 15 MB, Tauri/Rust, instant open, live reload — this is the tool I didn't know I needed for reviewing agent-generated docs. The Cmd+K fuzzy search across documents is the right power-user feature. Exactly the kind of focused tool that's worth having in your dock.”

“The primitive here is clean: a sandboxed agentic loop that reads your repo, writes diffs, and executes shell commands — all from stdin/stdout, composable with any Unix pipeline. The DX bet is that the terminal is the right abstraction layer, not a new IDE pane, and that's the correct call. The GitHub Actions integration is the moment of truth — if `npx codex run 'fix all failing tests'` in CI actually works without hallucinating imports or breaking unrelated files, this earns its keep. The specific technical decision that earns the ship: open source with a real repo, real npm package, real docs, and no 6-env-var bootstrap ceremony. Finally, a tool that ships as a tool.”

“Your IDE's preview panel and GitHub both render markdown fine. Marky solves a real but minor pain point — justifying a dedicated app for viewing markdown is a stretch for most developers. macOS-only also limits who can even use it.”

“Direct competitors are Claude Code and Aider, both of which have more mature multi-file refactor track records — so 'OpenAI ships it' is not automatically a win. The scenario where this breaks is any codebase with non-trivial context windows: monorepos over 100k tokens where the agent loses the thread and starts confidently editing the wrong abstraction layer. What kills this in 12 months is not a competitor — it's OpenAI itself shipping this natively into Cursor or VS Code and orphaning the CLI variant. What earns the ship today: open source and npm distribution mean the community will stress-test and patch it faster than any internal team would, and that matters.”

“Agentic workflows generate a constant stream of living documents — specs, changelogs, architecture decisions. A dedicated high-performance viewer for that output is the right primitive. Marky is small now but points at a category: real-time agent output viewers for humans in the loop.”

“The thesis: by 2027, CI pipelines will be partially staffed by agents that triage, patch, and PR without human initiation — and the terminal is the beachhead, not the destination. For this to pay off, model reliability on multi-file edits needs to cross a threshold where false-positive diff rates drop below the cost of human review, which is model-dependent and not guaranteed. The second-order effect nobody is talking about: if agentic CLI tools normalize, the power shifts from IDE vendors (JetBrains, Microsoft) toward API providers who own the execution loop — OpenAI is explicitly positioning for that capture. This tool is early on the 'CI-native agents' trend line, which means the composability primitives matter more than today's feature set.”

“Clean, fast, focused. The Mermaid diagram support means architecture docs actually render beautifully instead of showing raw text. For reviewing AI-generated technical writing, having a beautiful reader matters for catching errors in structure and flow.”

“The job-to-be-done is singular and honest: run a coding task autonomously in the terminal without context-switching to a browser or IDE. Onboarding via npm is the right call — `npm install -g @openai/codex` and you're one API key away from first value, which clears the 2-minute bar. The completeness problem is real though: for any task that requires visual feedback, browser interaction, or non-text asset handling, you're still dual-wielding, so this isn't a full replacement for heavier agents. The product's opinion — terminal-first, composable, sandboxed by default — is coherent and refreshingly not trying to be everything. That focus is the specific product decision that earns the ship.”