forge: add Ctrl+B as a secondary tmux prefix for macOS #11

Merged

pedromcaraujo merged 2 commits from fix/mac-tmux-prefix into main

2026-07-20 09:55:31 +01:00

pedromcaraujo commented

2026-07-20 07:27:54 +01:00

Owner

Summary

On macOS browsers the Ctrl+A tmux prefix doesn't reliably reach the shared tmux server — readline "beginning of line" wins before it hits the prefix binding, so split-pane navigation (prefix ←↑↓→, prefix z, …) breaks. Linux is unaffected.

tmux runs server-side with one shared config, so it can't detect the client OS and per-OS gating isn't possible. Instead:

Keep Ctrl+A as the primary prefix — Linux is unchanged.
Add Ctrl+B as a global secondary prefix (prefix2) as a reliable fallback on Mac.
Ctrl+B Ctrl+B still sends a literal Ctrl+B through (send-prefix -2), mirroring the Ctrl+A Ctrl+A behaviour.
Cheat sheet updated to advertise the Mac alternate.

Takes effect on next `nixos-rebuild` — the module's `reloadForgeTmux` activation script re-sources `/etc/tmux.conf` into the live shared server, so existing channels pick it up without killing sessions.

Test plan

`nix flake check` passes (CI)
Launcher parse passes (CI)
After rebuild: `Ctrl+A` prefix still works on Linux
`Ctrl+B` prefix works on macOS in a split-pane layout

Closes #10

## Summary On macOS browsers the `Ctrl+A` tmux prefix doesn't reliably reach the shared tmux server — readline "beginning of line" wins before it hits the prefix binding, so split-pane navigation (`prefix ←↑↓→`, `prefix z`, …) breaks. Linux is unaffected. tmux runs server-side with one shared config, so it can't detect the client OS and per-OS gating isn't possible. Instead: - Keep `Ctrl+A` as the **primary** prefix — **Linux is unchanged**. - Add `Ctrl+B` as a **global secondary** prefix (`prefix2`) as a reliable fallback on Mac. - `Ctrl+B Ctrl+B` still sends a literal `Ctrl+B` through (`send-prefix -2`), mirroring the `Ctrl+A Ctrl+A` behaviour. - Cheat sheet updated to advertise the Mac alternate. Takes effect on next \`nixos-rebuild\` — the module's \`reloadForgeTmux\` activation script re-sources \`/etc/tmux.conf\` into the live shared server, so existing channels pick it up without killing sessions. ## Test plan - [ ] \`nix flake check\` passes (CI) - [ ] Launcher parse passes (CI) - [ ] After rebuild: \`Ctrl+A\` prefix still works on Linux - [ ] \`Ctrl+B\` prefix works on macOS in a split-pane layout Closes #10

pedromcaraujo added 1 commit

2026-07-20 07:27:54 +01:00

forge: add Ctrl+B as a secondary tmux prefix for macOS (#10 )

CI / check (pull_request) Has been cancelled

Details

e0753f8d5c

macOS browsers don't reliably deliver Ctrl+A to the shared tmux server —
readline 'beginning of line' wins before it reaches the prefix binding, so
split-pane navigation breaks. tmux is server-side and can't detect the client
OS, so gate-per-OS isn't possible; instead keep Ctrl+A as the primary prefix
(Linux unchanged) and add Ctrl+B as a global secondary prefix (prefix2) as a
reliable fallback. Ctrl+B Ctrl+B still sends a literal Ctrl+B through.

Cheat sheet updated to advertise the Mac alternate.

Closes #10

pedromcaraujo added 1 commit

2026-07-20 07:53:06 +01:00

ci: re-trigger stuck Forgejo run

CI / check (pull_request) Successful in 41s

Details

ab7a56b656

pedromcaraujo merged commit 3bebdc7c46 into main

2026-07-20 09:55:31 +01:00

pedromcaraujo deleted branch fix/mac-tmux-prefix

2026-07-20 09:55:31 +01:00

pedromcaraujo referenced this pull request from a commit

2026-07-20 09:55:33 +01:00