- CollectionAgent Harnesses & Operator Surfaces
- Classificationagent-native
- LicenseMIT in package.json; no root LICENSE file as of 2026-09-26
- MCPUnavailable
- Agent SkillUnavailable
- InterfacesCLI
- Verified2026-09-26
What it does
Codex HUD launches Codex inside a managed tmux layout and renders a persistent terminal surface for model and reasoning effort, context fill, token counts, project/git state, session identity, configured extensions/Skills/hooks/instructions, approval and sandbox state, MCP/tool activity, and direct-child/subagent activity. A multi-session view aggregates active root sessions; typed agent paths preserve the visible subagent tree.
Its wrapper also provides bounded session operations: list, attach, create, diagnose, resume, or kill HUD-owned sessions. It observes Codex rather than replacing its reasoning or permission system, and it does not claim to authorize tool calls merely because it displays their state.
Agent-facing interfaces
- Interaction pattern: Codex wrapper CLI + tmux operator surface
- Catalog protocols: CLI
- MCP: ⚠️ No MCP server
- Agent Skill: ⚠️ Not published
- Onboarding type:
cli
How agents onboard
Interaction pattern: Codex wrapper CLI + tmux operator surface
Install codex-hud (https://github.com/fwyc0573/codex-hud) for the Codex CLI by following the instructions in its README.md.
See the full onboarding section in the dossier.
Protocol surface
| Interface | Detail |
|---|---|
| Wrapper CLI | codex, cx, codex-resume, and passthrough Codex arguments |
| Management CLI | codex-hud --list|--attach|--new-session|--kill|--self-check plus sync/upgrade/uninstall helpers |
| Codex inputs | Local config.toml, rollout/session JSONL, instruction/Skill/hook configuration, and git state |
| Terminal surface | tmux status pane with single-session and multi-session modes |
| Local state | Update/session state and logs under the XDG state directory or ~/.local/state/codex-hud/ |
There is no REST API, language SDK, or MCP transport.
Verification
Last verified 2026-09-26.
Sources:
- https://github.com/fwyc0573/codex-hud/releases/tag/v1.2
- https://api.github.com/repos/fwyc0573/codex-hud