tmux-bridge

Let AI agents run commands in your terminal.

tmux-bridge in action
tb start

Human starts a session, gets a session ID to share with the agent.

tb run -- cargo build

Agent runs a command synchronously, waits for output.

tb launch -- npm run dev

Agent starts a background task in a split pane.

tb check t1

Agent checks status and output of a background task.

Install

# Linux x86_64 curl -Lo ~/.local/bin/tb https://tmux-bridge.maxeonyx.com/releases/tb-x86_64-linux chmod +x ~/.local/bin/tb

Agent Skill

For OpenCode and compatible agents.

mkdir -p ~/.config/opencode/skills/tmux-bridge curl -sLo ~/.config/opencode/skills/tmux-bridge/SKILL.md \ https://maxeonyx.github.io/tmux-bridge/SKILL.md
--- name: tmux-bridge description: If a task requires interactive-only steps such as authentication, or background commands --- # tmux-bridge Use `tb` for interactive commands (sudo, auth) or background tasks. If "No session specified", ask user to run `tb start`. # Install curl -Lo ~/.local/bin/tb https://tmux-bridge.maxeonyx.com/releases/tb-x86_64-linux chmod +x ~/.local/bin/tb # Synchronous tb run -- sudo apt install foo # Background tasks tb launch -- cargo build # Start background task tb check t1 # Check status tb done t1 # Close pane