From 2e67afd7581ccc7d6b446cbe2bb251e87ca58b0c Mon Sep 17 00:00:00 2001 From: "takemi.ohama" Date: Thu, 19 Nov 2026 00:22:39 +0000 Subject: [PATCH] =?UTF-8?q?fix(tmux):=20=E5=85=A5=E3=82=8C=E5=AD=90?= =?UTF-8?q?=E3=81=AE=20tmux=20=E3=81=AE=E3=82=B3=E3=83=94=E3=83=BC?= =?UTF-8?q?=E3=82=92=E6=89=8B=E5=85=83=E3=81=AE=E3=82=AF=E3=83=AA=E3=83=83?= =?UTF-8?q?=E3=83=97=E3=83=9C=E3=83=BC=E3=83=89=E3=81=B8=E5=B1=8A=E3=81=91?= =?UTF-8?q?=E3=82=8B=EF=BC=88#528=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit base の tmux の既定に set -s set-clipboard on を足し、ペインの中のプログラムが送る OSC 52 を外側の端末へ中継する。既定の external では、内側の tmux の Ctrl+C のコピーを 外側の tmux が捨てていた。 テストは実効値の確認に加え、別ソケットで外側と内側の tmux を組み、内側の set-buffer -w が 外側のバッファに届くことを確かめる(変更前の設定では落ちる)。仕様書に入れ子の場合を書き足した。 Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01KYHP834rrrDgS7unQBUYSj --- CHANGELOG.md | 4 ++ containers/base/tmux.conf | 6 ++ .../kiro-auth-persistence-and-tmux-copy.md | 8 +++ tests/containers/test_tmux_conf.py | 63 +++++++++++++++++++ 4 files changed, 81 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index cec415fe..d07b3f20 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,6 +5,10 @@ ## [Unreleased] ### Fixed +- **tmux の中でさらに tmux を動かしたとき(入れ子)も、内側の tmux の `Ctrl+C` のコピーが手元の PC のクリップボードに + 届くようにしました(#528)。** base イメージの tmux の既定に `set -s set-clipboard on` を足し、ペインの中のプログラムが + 送る OSC 52 を外側の端末へ中継します。ペインの中から読み取ることはできません。元に戻すには `~/.tmux.conf` に + `set -s set-clipboard external` と書きます。**効かせるには base イメージを建て直します。** - **Remote-SSH で入ったホストの tmux から、手元の PC の VS Code にエディタが開くようにしました(#523)。** 以前のクライアントが作った tmux のペインで、IPC ソケットを tmux のセッション環境から拾い直しても、起動されるのは ペインの `PATH` の先頭にあるホストのデスクトップ版の `code` で、手元の PC には何も開いていませんでした。 diff --git a/containers/base/tmux.conf b/containers/base/tmux.conf index 539a164b..4f743679 100644 --- a/containers/base/tmux.conf +++ b/containers/base/tmux.conf @@ -24,6 +24,12 @@ bind-key -T copy-mode-vi MouseDrag1Pane select-pane \; send-keys -X begin-select bind-key -T copy-mode C-c send-keys -X copy-selection-and-cancel bind-key -T copy-mode-vi C-c send-keys -X copy-selection-and-cancel +# 入れ子の tmux など、ペインの中のプログラムが送る OSC 52 を外側の端末へ中継する (#528)。 +# 既定の external のままだと、内側の tmux の Ctrl+C のコピーが手元のクリップボードに届かない。 +# on でもペインの中から読み取ることはできない (tmux は OSC 52 の問い合わせに答えない)。 +# 戻すときは ~/.tmux.conf に set -s set-clipboard external と書く。 +set -s set-clipboard on + # 既定の 2000 行はビルドログ 1 回で流れ切る。pane あたりの上限であり、実際に使った # 分だけ確保するので固定の先取りは無い。 set -g history-limit 100000 diff --git a/docs/specifications/kiro-auth-persistence-and-tmux-copy.md b/docs/specifications/kiro-auth-persistence-and-tmux-copy.md index 0511a56c..75e3ae85 100644 --- a/docs/specifications/kiro-auth-persistence-and-tmux-copy.md +++ b/docs/specifications/kiro-auth-persistence-and-tmux-copy.md @@ -41,6 +41,14 @@ base イメージの tmux は `mouse on` を既定とし、マウスホイール 端末のクリップボードへ送り、copy-mode を終了する。コピーせずに選択を終了する場合は `q` を 使用する。ペインをまたぐ端末側の選択には `Shift` + ドラッグを使用する。 +tmux の中でさらに tmux を動かす(入れ子)場合も、内側の tmux の `Ctrl+C` で手元のクリップボードへ +届ける。内側の tmux は選択内容を OSC 52 で外側の tmux へ送る。外側の tmux は `set-clipboard` を +`on` とし、ペインの中のプログラムから来た OSC 52 を端末へ中継する。既定の `external` は tmux +自身のコピーだけを端末へ送り、ペインから来た OSC 52 を捨てるため、入れ子では届かない。 +`on` でもペインの中のプログラムはクリップボードを書き換えられるだけで、読み取ることはできない +(tmux は OSC 52 の問い合わせに答えない)。利用者は `~/.tmux.conf` に +`set -s set-clipboard external` と書けば元の動きに戻せる。 + `Ctrl+Home` は VS Code や Windows 側の操作と競合するため、tmux では割り当てない。 ## データ・設定 diff --git a/tests/containers/test_tmux_conf.py b/tests/containers/test_tmux_conf.py index 9b64e070..7e5b6609 100644 --- a/tests/containers/test_tmux_conf.py +++ b/tests/containers/test_tmux_conf.py @@ -145,6 +145,69 @@ def test_focus_events_is_on(options): assert options["focus-events"] == ["on"] +@needs_tmux +def test_set_clipboard_relays_osc52_from_panes(options): + """#528: ペインの中のプログラム (入れ子の tmux など) が送る OSC 52 を外側の端末へ中継する。 + + 既定の ``external`` は tmux 自身のコピーだけを端末へ送り、ペインから来た OSC 52 を捨てる。 + そのままだと入れ子の内側の tmux で ``Ctrl+C`` したものが手元のクリップボードに届かない。 + """ + assert options["set-clipboard"] == ["on"] + + +def _wait_until(predicate, timeout: float = 10.0) -> bool: + deadline = time.monotonic() + timeout + while time.monotonic() < deadline: + if predicate(): + return True + time.sleep(0.1) + return False + + +@needs_tmux +def test_nested_tmux_copy_reaches_outer_tmux(): + """#528: 内側の tmux のコピー (OSC 52) が外側の tmux のバッファに届く。 + + 外側と内側の両方に base の設定を読ませ、外側のペインから内側のサーバへ attach する。 + 内側で ``set-buffer -w`` (``Ctrl+C`` のコピーと同じく OSC 52 で端末へ送る) をすると、 + 外側が ``set-clipboard on`` なら外側のバッファにも同じ文字列が入る。 + """ + tag = uuid.uuid4().hex[:8] + outer = Path(tempfile.gettempdir()) / f"dvb528o-{tag}" + inner = Path(tempfile.gettempdir()) / f"dvb528i-{tag}" + env = {k: v for k, v in os.environ.items() if k != "TMUX"} + env["TERM"] = "xterm-256color" + o = ["tmux", "-S", str(outer)] + i = ["tmux", "-S", str(inner)] + text = f"nested-copy-{tag}" + try: + subprocess.run([*o, "-f", str(TMUX_CONF), "new-session", "-d", "-x", "120", "-y", "30"], + env=env, check=True, capture_output=True) + subprocess.run([*i, "-f", str(TMUX_CONF), "new-session", "-d", "-s", "in"], + env=env, check=True, capture_output=True) + subprocess.run([*o, "send-keys", f"env -u TMUX tmux -S {inner} attach -t in", "Enter"], + env=env, check=True, capture_output=True) + + def attached() -> bool: + shown = subprocess.run([*i, "list-clients"], env=env, capture_output=True, text=True) + return bool(shown.stdout.strip()) + + assert _wait_until(attached), "外側のペインから内側の tmux へ attach できなかった" + subprocess.run([*i, "set-buffer", "-w", text], env=env, check=True, capture_output=True) + + def relayed() -> bool: + shown = subprocess.run([*o, "list-buffers"], env=env, capture_output=True, text=True) + return text in shown.stdout + + assert _wait_until(relayed), "内側のコピーが外側の tmux のバッファに届かない" + finally: + for base in (i, o): + subprocess.run([*base, "kill-server"], env=env, capture_output=True) + for sock in (inner, outer): + with contextlib.suppress(FileNotFoundError): + sock.unlink() + + @needs_tmux def test_default_terminal_is_tmux_256color(options): """条件 4: tmux の版に依らず tmux-256color へ固定する。"""