Codexだけで開発した glowm – ターミナルでMermaidを描画できるMarkdown CLIツール

はじめに

「ターミナルでMarkdownを見ながら、Mermaidの図もそのまま確認したい」

そんな思いから始まったglowmの開発。今回は特別なチャレンジとして、OpenAI Codexのみで開発を進めてみました。要件整理から実装、テスト、リリースまで、すべてCodexとの対話で完結させた記録です。

glowmは、Glow風のMarkdown表示機能に加えて、Mermaidダイアグラムをターミナル内で画像として表示できるCLIツールです。

# 基本的な使い方
glowm README.md

# 標準入力から
cat README.md | glowm -

# PDF出力
glowm --pdf README.md > diagram.pdf

最初は「Glow相当 + mermaid-cli相当 + 標準出力」という漠然とした要望からスタート。Codexと対話する中で、以下のように仕様が固まっていきました。

重要だったのは「URL/GitHub入力の意義が不明」という指摘。ローカルファイルとSTDINのみに限定することで、シンプルな仕様に収束しました。

MVP実装後、大きな問題が発覚しました。

「ANSIで出力しても、Mermaidの図が見えない」

当初はMermaidをテキストとして表示していましたが、「端末内で図として見たい」という本来の目的に立ち返り、実装方針を大きく変更。

この方針転換がglowmの最大の特徴になりました。

Codexとの対話で、表示品質を段階的に改善しました。

GitHub pushからHomebrew Formula作成まで、Codexの指示通りに進めました。

brew tap atani/tap
brew install glowm

chromedpを使い、ヘッドレスChromeでMermaid.jsを実行します。mermaid-cliのインストール不要で、Mermaidのレンダリングを実現しています。

iTerm2とKittyは、Base64エンコードした画像をエスケープシーケンスで出力することで、インライン画像表示ができます。glowmは端末を自動検出し、適切なプロトコルで出力します。

glowmは「ターミナルでMarkdownとMermaidを一緒に見たい」というシンプルな欲求から生まれました。Codexとの開発は、要件の整理から実装、リリースまで一気通貫で進められる新しい開発体験でした。

ぜひ試してみてください。