Organizing Coder Terminals

Problem

When running multiple AI coding agents (Claude, Kimi, Qwen, OpenCode) in separate GNOME Terminal windows, every tab looks identical — usually titled by the running process name (e.g., "Kimi Code"). After opening 3–4 terminals, it becomes impossible to tell at a glance which terminal belongs to which project without clicking into each one.

GNOME Terminal 3.44+ removed the "Set Title" option from the tab right-click menu, eliminating the old manual workaround.

Solution

Use tmux inside every terminal:

• One named tmux session per project (e.g., claude, kimi, qwen)
• A title bash command that renames both the tmux window and the terminal title
• Persistent panes — if an AI agent crashes, the pane stays alive and can be respawned

Quick Start

Launch All Agents at Once

Run on the Ubuntu desktop:

~/start_dev_env.sh

This opens 5 GNOME Terminal windows:

#	Window Title	Tmux Session	Purpose
1	Claude Code — tmux	claude	Claude Code AI agent
2	OpenCode Claude — tmux	opencode-claude	OpenCode (Claude provider)
3	OpenCode Kimi — tmux	kimi	OpenCode (Kimi provider)
4	OpenCode Qwen — tmux	qwen	OpenCode (Qwen provider)
5	Tmux — General	general	Plain bash for git, docker, file ops

Each session survives even if the GNOME Terminal window is closed.

Launch Individual Agents

Double-click any desktop launcher:

• ~/Desktop/claude.sh
• ~/Desktop/kimi.sh
• ~/Desktop/opencode.sh
• ~/Desktop/Qwen.sh

Each launcher auto-creates or reattaches to its tmux session.

How to Title Your Session

The Default Title Is the Command Itself

Every new terminal opens with the title:

title "project"

This is intentional — the default title is the command reminder. You never forget the syntax because it's staring at you from the tab.

Change It

Inside any terminal, type:

title "ce char gen"

This does two things:

1. Renames the tmux window (visible in the green status bar at the bottom)
2. Sets the GNOME Terminal tab/window title

Change it anytime:

title "mneme shipgen"
title "IT-knowledge docs"
title "$(hostname)"   # reset to hostname

The title auto-resets after every shell prompt, so AI agents cannot overwrite it.

Tmux-Only Renaming

tmux rename-window "my project"     # rename current window
tmux rename-session "newname"       # rename entire session

Key Shortcuts

Key	Action
Ctrl+b ,	Rename current window (interactive prompt)
Ctrl+b r	Respawn pane (restart AI agent if it crashed)
Ctrl+b d	Detach session (keeps it running in background)
	Split pane horizontally
Ctrl+b -	Split pane vertically
Alt+Arrow	Switch panes
Ctrl+b R	Reload tmux config

Reattaching to Sessions

If a terminal window is closed, the tmux session keeps running:

tmux list-sessions
tmux attach-session -t claude
tmux attach-session -t kimi

Aliases added to ~/.bashrc:

tls     # list sessions
tas claude    # attach to claude session

Configuration Files

File	Purpose
~/.tmux.conf	Tmux settings (status bar, mouse, key bindings)
~/.bashrc	title() function + auto-reset + tmux aliases
~/.config/tmux-launcher.sh	Helper script for desktop launchers

Troubleshooting

Symptom	Cause	Fix
Title shows "Kimi Code" instead of custom	AI resets it via escape sequences	PROMPT_COMMAND auto-resets after every prompt
Tab right-click has no "Set Title"	GNOME Terminal 3.44+ removed it	Use title bash command or Ctrl+b ,
title command not found	.bashrc not loaded	Start an interactive shell, or run source ~/.bashrc
Default title shows title "project"	Working as designed — it's the syntax reminder	Type title "your real project" to replace it
AI agent crashed and pane is dead	Process exited	Press Ctrl+b r to respawn
Session already exists	Previous session still running	tmux attach -t <name> or tmux kill-session -t <name>

See Also

• IT Knowledge Base
• Forgejo
• Docker Stacks