codexstatusline

A Codex CLI native footer configurator forked from ccstatusline.

Codex does not currently use Claude Code's external statusLine.command JSON pipe. Instead, it reads built-in footer item identifiers from tui.status_line in ~/.codex/config.toml. This fork maps compatible widgets to Codex's plain native footer items.

What Works

• Interactive TUI for choosing Codex native footer items.
• Install action that writes tui.status_line = [...] to Codex config.toml.
• Existing local renderer and preview for experimenting, with the caveat that Codex will not render that preview.
• Codex config discovery via CODEX_HOME, with CLAUDE_CONFIG_DIR accepted as a legacy fallback.
• Codex transcript and cache helpers for usage, context, block timers, and token widgets where compatible.

Important Limitation

Codex only accepts its built-in status-line item ids. The installed Codex footer is plain Codex UI text. Custom colors, labels, separators, powerline rendering, arbitrary command widgets, and multi-line formatting from the preview cannot be installed into Codex until Codex exposes an external status-line formatter API.

Supported widget mappings include:

model -> model
thinking-effort -> model-with-reasoning
current-working-dir -> current-dir
git-branch -> git-branch
context-percentage -> context-used
context-length/context-window -> context-window-size
tokens-total -> used-tokens
tokens-input -> total-input-tokens
tokens-output -> total-output-tokens
block timer/reset -> five-hour-limit
weekly usage/reset -> weekly-limit
version -> codex-version
session-name -> thread-title
codex-session-id -> session-id

Unsupported widgets are skipped during install.

Usage

Install from npm:

npm install -g @paulmagos/codexstatusline
codexstatusline

Or run without installing:

npx @paulmagos/codexstatusline

For local development:

bun install
bun run start

From the TUI, choose native-compatible items and select Configure Codex status line. The installer updates:

~/.codex/config.toml

Example output:

[tui]
status_line = ["model-with-reasoning", "current-dir", "git-branch", "context-used"]

To disable the Codex status line, use the uninstall action in the TUI. It writes:

[tui]
status_line = null

Development

bun run lint
bun test
bun run build

The bundled binary is written to dist/codexstatusline.js.