やりたかったこと
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 を確認しました。
(が、有力な情報は記載されていませんでした)
ここでは Codex CLI の概要と、詳細は GitHub repo を見る流れが案内されています。
具体的な status_line の例は、OpenAI 公式 GitHub repo の issue で確認しました。
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",