Codex HUD CLI
Statusline HUD for Codex CLI inside tmux: context fill, tokens, branch, MCP servers and subagents stay visible in the session.
- 80 ★ on the repository
- Last commit
Extended access
Why this level
- Runs a background process that sends text into tmux sessions.
- Installation edits shell configuration files and reads local Codex session data.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/codex-hudDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Runs a background process that sends text into tmux sessions.
- Installation edits shell configuration files and reads local Codex session data.
This is third-party code. Review the repository files before installing.
What it does
Codex HUD runs Codex CLI inside a preconfigured tmux and keeps a five-row panel at the bottom of the terminal. It shows the model and reasoning effort, a context fill bar, project and git branch, counts of MCP servers, skills and hooks, approval and sandbox mode, token usage, running tool calls and active subagents. The `cx` command starts Codex with the panel while `codex` still launches the stock client. `Ctrl+T` switches to an overview of every active session. A separate `cx-continue` module detects the OpenAI "capacity exceeded" block and sends continue to the session so the task resumes.
Who it is for. Developers who run several Codex CLI sessions and want to see context, tokens and permissions without extra commands.
Good fit when
- A long Codex task approaches the context limit and you need a fill bar before compaction.
- Several sessions run at once and the `Ctrl+T` overview shows the load of each.
- An overnight run often stops on the "capacity exceeded" block and the session must resume automatically.
- You want to see the approval and sandbox mode at a glance without opening settings.
Not a fit when
- Work happens on Windows without WSL: Windows support is marked early and lives on a separate branch.
- You need a panel for Claude Code: a different project, claude-hud, exists for it.
- Automatic continue is unwanted: the `cx-continue` module is started by a separate command.
Example request
Install Codex HUD following the repository instructions, run `cx` in the project and show how much context is used.Limitations
Codex CLI 0.140.0 or newer and tmux are required; the installer adds tmux when it is missing. The main branch targets macOS and Linux, while Windows through WSL lives on the `feature/windows-support-dual-entry` branch and is described as unstable. Installation clones the repository and appends aliases to `.zshrc` or `.bashrc`. The repository states no license, so clarify the terms with the author. Auto-continue is started manually and sends text to the session without your confirmation.
How to disable. Run `codex-hud-uninstall`: it removes the aliases and stops HUD sessions. Stop auto-continue with `./bin/cx-continue-ctl stop` in the `cx-continue` folder, and the clone can be deleted.
FAQ
How does `cx` differ from `codex`?
`cx` launches Codex CLI with the HUD in tmux while `codex` remains the stock launch without the panel.
How do I enable automatic continue?
Go to the `cx-continue` folder and run `./bin/cx-continue-ctl start`. The `status`, `stop`, `restart` and `logs` commands manage the background process.
How do I update the HUD?
`codex-hud-upgrade` fetches, verifies and activates the latest build in steps. `codex-hud-sync` rebuilds the aliases for the current checkout.
Do I need to install tmux by hand?
No. The HUD enables tmux itself, and the installer adds it when it is missing.
What does the panel show?
Model, context bar, branch, counts of MCP servers, skills and hooks, approval mode, tokens, tool calls and subagents. `Fast` reflects the active priority service tier.
Discussion
No questions or reviews yet.
Related
CLI toolsCodex MCP Tool (cexll)
Codex MCP Tool
An MCP server that sends tasks to Codex CLI from Claude Code and Cursor: code review via @ refs, a sandbox, patch edits, ideas
A layer on top of OpenAI Codex that adds project memory, planning and completion checks before a task counts as done
Codex Bridge sends questions and file analysis from Claude Code, Cursor and VS Code to the official Codex CLI via Python MCP.
Codex Trace reads local Codex CLI logs and shows turns, tool calls and token usage in a desktop window or in the browser.
Codex Settings skills
Codex CLI Skills & Profiles
A Codex CLI plugin with twelve skills: deep research, pull request review, image generation and session handoff
A kit for porting a Claude Code workflow to OpenAI Codex CLI for multi-tenant PHP/Bitrix24-Marketplace projects
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| Codex HUD (this card) | no | 80 | |
| Claude HUD | no | 29,182 | the same idea for Claude Code as a plugin; Codex HUD works with Codex CLI, runs it in tmux and can resume after blocks |
| Codex Privacy HUD | no | 110 | shows which personal data the agent sees; Codex HUD tracks context, tokens and session state |
README in short
The document explains why a panel is useful, shows installation for macOS, Linux and WSL and lists management commands. It then describes the panel rows, compact and expanded modes and settings through `CODEX_HUD_*` variables.