# instinct: tmuxペイン系操作はセッション名のみの=name指定では解決されず=name:(コロン付き)が必要

tmux のペイン/ウィンドウ系操作（`select-pane` / `capture-pane` / `pipe-pane` / `clear-history`）に
`-t "=セッション名"` を渡すと `can't find pane: =name` で失敗する（tmux 3.4 実証）。

**Why:** `=` は完全一致マーカーだが、ペインターゲットとしてセッション名単体は解決されない。
`=name:`（末尾コロン付き）で「そのセッションのカレントウィンドウ」に解決される。

**How to apply:**
- ペイン系: `tmux capture-pane -t "=${name}:" -p` のようにコロンを付ける
- セッション系（`has-session` / `kill-session` / `attach` / `switch-client`）は `=name` のままでOK
- `2>/dev/null` で握り潰すと「clean: 0 セッション」のように静かに全件失敗するので、スモークテストで件数まで確認する

関連: [[project-tmux-ai-workflow]] / `~/.claude/scripts/ai-tmux.sh` (claude-base#65)

---
(migrated from local memory/instinct_tmux_pane_target_needs_colon.md)