tmux auto-start menu hung on mosh

omarz commented

2026-04-23 17:45:35 +00:00

Member

After a fresh hero_skills install, the tmux auto-start menu hung on mosh (output rendered but keystrokes and Ctrl+C didn't reach the shell), and SSH skipped the menu entirely and dropped into plain bash.

Root cause

Mosh hang: the menu ran inline while .bashrc was being sourced, before bash had claimed the controlling TTY. Under mosh's startup timing, read blocked on a TTY the shell didn't yet own, so neither input nor SIGINT could be delivered.
SSH skip: SSH login shells read ~/.profile, not ~/.bashrc. The multi_user_add-generated ~/.profile exported env vars but never bridged to .bashrc, so ~/hero/cfg/init.sh (and its tmux block) never loaded on SSH login.

Fix

Tmux block (generate_init_sh heredoc): install the menu as a _hero_tmux_menu function registered via PROMPT_COMMAND. Bash fires it once, right before the first prompt, after TTY ownership is complete — so read and signals work under both ssh and mosh. Function
detaches itself from PROMPT_COMMAND on entry so Ctrl+C falls back to a normal bash prompt instead of re-firing.
patch_shell_rc_files: on Linux, append a $BASH_VERSION-guarded . ~/.bashrc to ~/.profile (idempotent — skipped if already bridged). SSH login shells now pick up init.sh the same way mosh does.

After a fresh hero_skills install, the tmux auto-start menu hung on mosh (output rendered but keystrokes and Ctrl+C didn't reach the shell), and SSH skipped the menu entirely and dropped into plain bash. ### Root cause - Mosh hang: the menu ran inline while .bashrc was being sourced, before bash had claimed the controlling TTY. Under mosh's startup timing, read blocked on a TTY the shell didn't yet own, so neither input nor SIGINT could be delivered. - SSH skip: SSH login shells read ~/.profile, not ~/.bashrc. The multi_user_add-generated ~/.profile exported env vars but never bridged to .bashrc, so ~/hero/cfg/init.sh (and its tmux block) never loaded on SSH login. ### Fix - Tmux block (generate_init_sh heredoc): install the menu as a _hero_tmux_menu function registered via PROMPT_COMMAND. Bash fires it once, right before the first prompt, after TTY ownership is complete — so read and signals work under both ssh and mosh. Function detaches itself from PROMPT_COMMAND on entry so Ctrl+C falls back to a normal bash prompt instead of re-firing. - patch_shell_rc_files: on Linux, append a $BASH_VERSION-guarded . ~/.bashrc to ~/.profile (idempotent — skipped if already bridged). SSH login shells now pick up init.sh the same way mosh does.