pi-for-office-tmux-bridge

Local HTTPS tmux bridge helper for Pi for Office.

Usage

npx pi-for-office-tmux-bridge

This command:

1. Ensures mkcert exists (installs via Homebrew on macOS if missing)
2. Creates certificates in ~/.pi-for-office/certs/ when needed
3. Starts the bridge at https://localhost:3341
4. Runs in real tmux mode by default

Real mode requires tmux to be installed and available on PATH.

Optional assisted install (macOS/Homebrew):

npx pi-for-office-tmux-bridge --install-missing

This installs missing tmux before starting the bridge.

To force safe simulated mode:

TMUX_BRIDGE_MODE=stub npx pi-for-office-tmux-bridge

Then in Pi for Office:

1. The default tmux bridge URL is already https://localhost:3341
2. (Optional) set /experimental tmux-bridge-url <url> to use a non-default URL
3. (Optional) run /experimental tmux-bridge-token <token> if you set TMUX_BRIDGE_TOKEN

Publishing (maintainers)

Package source lives in pkg/tmux-bridge/.

Before packing/publishing, prepack copies runtime files from repo root:

• scripts/tmux-bridge-server.mjs

Publish from this directory:

cd pkg/tmux-bridge
npm publish