やりたかったこと

Codex のステータスバーに次を出したかった。

モデル名
現在のディレクトリ
Git ブランチ
コンテキスト残量
5時間制限
weekly 制限
fast mode

完成品↓

環境

macOS
codex-cli 0.130.0
設定ファイル: ~/.codex/config.toml

codex --version

codex-cli 0.130.0

参照したもの

まず OpenAI Help Center を確認しました。
(が、有力な情報は記載されていませんでした)

OpenAI Codex CLI - Getting Started

ここでは Codex CLI の概要と、詳細は GitHub repo を見る流れが案内されています。

具体的な status_line の例は、OpenAI 公式 GitHub repo の issue で確認しました。

Support external command-based status line with ANSI colors, similar to ClaudeCode

issue 内に、次のような設定例があります。

[tui]
status_line = [
  "model-with-reasoning",
  "current-dir",
  "git-branch",
  "context-remaining",
  "five-hour-limit",
  "weekly-limit",
  "fast-mode"
]

詰まったところ

公式リファレンスだけだと five-hour-limit や weekly-limit のような status line の候補名が見つけにくかったです。そのため、GitHub issue の設定例を見たうえで、手元の Codex CLI にその文字列が含まれているかも確認しました。

strings /opt/homebrew/lib/node_modules/@openai/codex/node_modules/@openai/codex-darwin-arm64/vendor/aarch64-apple-darwin/codex/codex \
  | rg "status_line|five-hour-limit|weekly-limit|context-remaining|model-with-reasoning|current-dir|git-branch|fast-mode"

これで、手元の codex-cli 0.130.0 に対象セグメントが入っていることを確認しました。

もう一点、既存設定に [tui.model_availability_nux] がありました。そこへ直接 status_line = [...] を追記すると別テーブル扱いになる可能性があるため、その前に [tui] セクションを追加しました。

設定した内容

~/.codex/config.toml に以下を追加しました。

[tui]
status_line = [
  "model-with-reasoning",
  "current-dir",
  "git-branch",
  "context-remaining",
  "five-hour-limit",
  "weekly-limit",
  "fast-mode",
]
status_line_use_colors = true

既存の [tui.model_availability_nux] がある場合は、その前に置きます。

[tui]
status_line = [
  "model-with-reasoning",
  "current-dir",
  "git-branch",
  "context-remaining",
  "five-hour-limit",
  "weekly-limit",
  "fast-mode",
]
status_line_use_colors = true

[tui.model_availability_nux]
"gpt-5.5" = 4

こうなればOK

確認

設定ファイルが読めるかは、次で確認しました。

codex debug models

自分の環境では次の warning が出ましたが、コマンド自体は成功しました。

WARNING: proceeding, even though we could not update PATH: Operation not permitted (os error 1)

実際のステータスバー表示は、新しい Codex TUI セッションを開くと反映されます。

codex

まとめ

Codex CLI のステータスバーは、~/.codex/config.toml の [tui] status_line で変更できます。

5時間制限と weekly 制限を見たい場合は、少なくともこの2つを入れればよさそうです。

"five-hour-limit",
"weekly-limit",