whatisgithub

What is cmux-autotab-naming?

johnlindquist/cmux-autotab-naming — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 2/5Setup · easy

In one sentence

A Codex CLI plugin that automatically renames your cmux terminal tab with a short title generated from each prompt you submit.

Mindmap

mindmap
  root((repo))
    What it does
      Renames cmux tabs
      Runs on prompt submit
      Uses isolated agent
    Tech stack
      Python
      Codex CLI
      cmux CLI
    Use cases
      Track many chats
      Auto label sessions
      Customize via env vars
    Audience
      Developers
      Codex users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Automatically label cmux terminal tabs so you can tell multiple Codex conversations apart at a glance.

USE CASE 2

Run background title generation without blocking or slowing down your main Codex session.

USE CASE 3

Customize which model generates tab titles or disable the plugin entirely with environment variables.

What is it built with?

PythonCodex CLIcmux

How does it compare?

johnlindquist/cmux-autotab-naming0xhassaan/nn-from-scratch3ks/embedoc
Stars00
LanguagePythonPythonPython
Last pushed2023-06-08
MaintenanceDormant
Setup difficultyeasymoderatehard
Complexity2/54/51/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires the Codex CLI with hooks and plugins enabled, plus the cmux CLI on PATH.

So what is it?

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.

Copy-paste prompts

Prompt 1
Explain how the UserPromptSubmit hook in cmux-autotab-naming triggers a background title agent.
Prompt 2
Walk me through installing cmux-autotab-naming from GitHub into my Codex plugin marketplace.
Prompt 3
Show me how to change the model used for tab title generation in this plugin.
Prompt 4
Help me write a smoke test similar to this project's tests/smoke_test.py for a Codex plugin.

Frequently asked questions

What is cmux-autotab-naming?

A Codex CLI plugin that automatically renames your cmux terminal tab with a short title generated from each prompt you submit.

What language is cmux-autotab-naming written in?

Mainly Python. The stack also includes Python, Codex CLI, cmux.

How hard is cmux-autotab-naming to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is cmux-autotab-naming for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.