guanhuaye/codex-tmux-scroll

Codex is an AI coding assistant that runs in the terminal. When you use it inside tmux, a popular tool for managing multiple terminal sessions at once, the default mouse behavior gets in the way: scrolling the mouse wheel navigates through your command history instead of letting you read back through your AI conversation. This project fixes that problem. codex-tmux-scroll is a modified build of the Codex CLI, patched specifically for tmux users. When you scroll the mouse wheel, it moves through your Codex conversation history rather than interfering with the terminal. The history view freezes in place while you read it, so new output does not push your reading position around. A small indicator shows how far back in the conversation you are. The input box stays visible at the bottom of the screen the whole time. If you use your mouse to drag and select text in the conversation, it copies to your clipboard. Double-clicking near the input box jumps you back to the most recent output. Installation is a single curl command for Linux x86_64 systems. The installer places the binary and a wrapper script in your home directory without touching your existing codex setup. You run it as codex-tmux-scroll instead of codex, and all the normal Codex arguments work the same way. The project does not copy the entire Codex source code into this repository. Instead it keeps a small patch file that records only the tmux-specific changes. When the upstream Codex CLI releases a new version, the maintainer rebases that patch onto the new release, rebuilds the binary, and publishes a new GitHub release. Users update by running the same install command again. This is a focused tool for one specific workflow: developers who run long Codex sessions inside tmux and want their mouse to behave sensibly. If you do not use tmux, this project offers nothing over the standard Codex CLI.