johnlindquist/cmux-autotab-naming — explained in plain English
Analysis updated 2026-05-18
Automatically label cmux terminal tabs so you can tell multiple Codex conversations apart at a glance.
Run background title generation without blocking or slowing down your main Codex session.
Customize which model generates tab titles or disable the plugin entirely with environment variables.
| johnlindquist/cmux-autotab-naming | 0xhassaan/nn-from-scratch | 3ks/embedoc | |
|---|---|---|---|
| Stars | 0 | 0 | — |
| Language | Python | Python | Python |
| Last pushed | — | — | 2023-06-08 |
| Maintenance | — | — | Dormant |
| Setup difficulty | easy | moderate | hard |
| Complexity | 2/5 | 4/5 | 1/5 |
| Audience | developer | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires the Codex CLI with hooks and plugins enabled, plus the cmux CLI on PATH.
This is a plugin for the Codex command-line tool that automatically renames your terminal tab with a short, descriptive title each time you submit a prompt. If you use Codex inside cmux (a terminal multiplexer), your tabs might have generic names that make it hard to track which conversation is which. This plugin solves that by giving each tab a meaningful name based on what you typed. Here is how it works: when you submit a prompt in Codex, a hook called UserPromptSubmit fires. The plugin captures that event, then immediately returns control to Codex so your conversation continues without any delay. In the background, a separate isolated Codex agent runs to generate a short title for the prompt. Once it has a title, it calls the cmux command to rename the active tab. The background agent is intentionally stripped of access to hooks, plugins, memory, and project documents so it cannot interfere with your main session. The plugin is written in Python and requires Python 3.9 or newer. It also requires the Codex CLI with hook support and the cmux CLI both available on the system. Installation is handled through Codex's plugin marketplace. Diagnostic logs are written to a JSONL file in the Codex logs directory, and several environment variables allow you to customize the model used for title generation, override binary paths, or disable the plugin without uninstalling it.
A Codex CLI plugin that automatically renames your cmux terminal tab with a short title generated from each prompt you submit.
Mainly Python. The stack also includes Python, Codex CLI, cmux.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Verify against the repo before relying on details.