codex-tmux-statusline
v0.1.0
Published
Install a tmux launcher plus recent-request statusline for existing Codex CLI setups
Maintainers
Readme
codex-tmux-statusline
Minimal installer for existing Codex CLI users who want one thing only:
- tmux launcher for Codex sessions
- recent-request statusline via tmux window names
It does not touch:
~/.codex/config.tomlAGENTS.md- skills
- MCP setup
- your existing
cxtwrapper, unless you do not have one yet
Install
npx -y codex-tmux-statusline@latestWhat it installs:
~/.codex/scripts/codex-tmux.sh~/.codex/scripts/codex-statusline.mjs~/.local/bin/codex-tmux-statusline~/.local/bin/cxtonly when no existingcxtis present
On Windows it installs PowerShell and CMD wrappers in the same ~/.local/bin location.
Behavior
- checks whether
tmuxis available - auto-installs
tmuxwhen a supported package manager is available - launches Codex inside tmux
- updates the tmux window name to
rq: <recent request summary>
The launcher defaults to plain codex, so it works with existing Codex setups instead of assuming a custom profile.
Commands
codex-tmux-statusline
codex-tmux-statusline safe
codex-tmux-statusline --profile careful
codex-tmux-statusline lsIf the installer created cxt, the same commands work through cxt.
Platform notes
- macOS Apple Silicon and Intel: uses Homebrew when
tmuxis missing - Linux and WSL: uses
apt-get,dnf,pacman, orzypper - Windows: installs MSYS2 through
winget,choco, orscoopwhen needed, then installstmuxthrough MSYS2pacman
Native Windows support is implemented through PowerShell/CMD wrappers that call the same tmux launcher inside MSYS2 bash. Existing Codex config and repo setup stay untouched.
