Jump to content

Organizing Coder Terminals

From MediawikiCIT
Revision as of 07:27, 2 May 2026 by Justinaquino (talk | contribs) (Updated: default title is now the command reminder 'title "project"' (2026-05-02))

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