cosgroveb

Claude Tmux Namer — Development skill for Claude Code

Development community

Claude Code plugin that automatically renames your tmux window based on conversation context.

How to install Claude Tmux Namer

This entry records only its repository, not the path inside it, so there is no exact command to give. Open cosgroveb/claude-tmux-namer and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Claude Tmux Namer does

Claude Code plugin that automatically renames your tmux window based on conversation context.

Alternatives in Development

Cmux — cmux: tmux for Claude Code 600 ★
Tmux Claude Hatch — tmux plugin that runs Claude Code sessions in popups per project directory, with an fzf picker showing each se 381 ★
Leantoken — Code intelligence for agents: find the code that matters and keep your context window and tokens lean 103 ★

README

claude-tmux-namer

[![Validate Plugin](https://github.com/cosgroveb/claude-tmux-namer/actions/workflows/validate.yml/badge.svg)](https://github.com/cosgroveb/claude-tmux-namer/actions/workflows/validate.yml)

A Claude Code plugin that automatically renames your tmux window with a short phrase describing your current work.

How it works

After each Claude response, a Haiku agent reads the conversation context via `--continue` and generates a 2-4 word lowercase phrase (e.g., "fixing auth bug", "adding api endpoint"). The phrase becomes your tmux window name.

Asynchronous: Fires off another claude and uses haiku
Context-aware: Has full conversation history via --continue
Graceful: Silently skips if not in tmux or if anything fails

Installation

Using Claude Code slash commands:

/plugin marketplace add git@github.com:cosgroveb/claude-tmux-namer.git
/plugin install tmux-window-namer@claude-tmux-namer

Or clone and install manually:

git clone git@github.com:cosgroveb/claude-tmux-namer.git
cd claude-tmux-namer
make install

Uninstallation

/plugin uninstall tmux-window-namer
/plugin marketplace remove claude-tmux-namer

Or manually:

cd claude-tmux-namer
make uninstall

Requirements

Claude Code CLI
tmux

FAQ

How much does this cost?

Each rename uses Claude Haiku, the cheapest Claude model. Costs depend on whether Claude Code's context is cached:

Scenario	Cost	When it happens
Cached	~$0.003	Most calls—when you're actively working
Not cached	~$0.03-0.05	First call in a session, or after ~5 min idle

**Why the difference?** Claude Code sends ~30K tokens of system context with each API call. The API caches this context for ~5 minutes. Cached reads cost 1/10th as much. Since you're typically maki