skills.rest
taptap
taptapOFFICIAL
Explore all skills by this author →
Website𝕏@taptapGitHub

codex-statusline

Install and configure the Codex statusline across tmux, iTerm2, and the Codex TUI.

Updated Aug 27, 2026
Search Tags:#automation#codex#tmux#shell#statusline#iterm2#install
One-click install
npx skills add https://github.com/taptap/agents-plugins --skill codex-statusline
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codex-statusline
Source: https://github.com/taptap/agents-plugins/tree/main/plugins/sync/skills/codex-statusline
Command: npx skills add https://github.com/taptap/agents-plugins --skill codex-statusline

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps terminal status displays consistent by installing the codex-status binary, configuring shell hooks, and synchronizing the Codex TUI status_line setting so users see the same status information across tmux and iTerm2.

Core Features & Use Cases

  • Automated Installation: Locates the plugin scripts and runs the installer to place codex-status in ~/.local/bin.
  • Configuration Sync: Updates the Codex TUI status_line in ~/.codex/config.toml to the official set of status fields.
  • Shell and Terminal Hooks: Adds zsh/iTerm2 hooks to display the new statusline and notifies users when iTerm2 needs a restart.
  • Use Case: A developer who uses tmux and iTerm2 can run this workflow to ensure their Codex status information is installed and consistently shown across sessions.

Quick Start

Run the skill to locate the plugin scripts and execute the installer so codex-status is installed, zsh hooks are configured, and the Codex TUI status_line in ~/.codex/config.toml is synchronized.

Frequently Asked Questions about codex-statusline

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install and sync the Codex statusline across tmux and iTerm2?▼

To install the Codex statusline, run the installer script to place codex-status in ~/.local/bin, add zsh and iTerm2 hooks, and synchronize the status_line setting in ~/.codex/config.toml for consistent terminal display.

What does synchronizing the Codex TUI status_line in config.toml do?▼

Synchronizing the status_line in ~/.codex/config.toml updates the Codex TUI to display the official set of status fields, ensuring your terminal status information remains consistent across tmux and iTerm2 sessions.

Do I need a specific shell to configure Codex statusline hooks?▼

Yes, you need a bash-capable shell to execute the ensure-codex-statusline.sh installer script and write permissions for your shell rc files to properly configure zsh and iTerm2 statusline hooks.

Why does my iTerm2 statusline not update after running the Codex installer?▼

After configuring iTerm2 hooks to display the Codex statusline, the installer notifies users when iTerm2 needs a manual restart to apply the new shell hooks and render the updated status display.

Can I use this Codex statusline setup for local developer environments only?▼

Yes, the Codex statusline installation applies to local developer environments and terminal workflows, requiring access to the plugin scripts directory and write permissions for local configuration files.

What is the best way to keep terminal status displays consistent when using Codex?▼

Automated installation of the codex-status binary combined with configuration sync in ~/.codex/config.toml and shell hooks ensures users see the same Codex status information consistently across terminal sessions.

Related Skills

Explore More Software Engineering Skills→
smarmen86smarmen86

unfreeze

Deletes the freeze state file to restore write access across project directories.

Community
Basic
hiromimahiromima

tmux × iTerm2 Integration

Automate tmux session orchestration with iTerm2 dynamic profiles for agent panes.

Community
Advanced
yellow-seedyellow-seed
2

sync-codex

Port Dockerfile RUN and ENV steps into portable shell scripts for Codex environments.

Community
Advanced
wesleyegbertowesleyegberto
3

terminal-monitor

Open a named tmux or iTerm2 pane to monitor real-time subagent or team output.

Community
Intermediate