tmux
A terminal multiplexer that lets you run and manage multiple terminal sessions within a single window.
In Depth
tmux (terminal multiplexer) is a command-line tool that lets you create, manage, and switch between multiple terminal sessions within a single window. It provides session persistence (sessions survive disconnection), window management (multiple workspaces within a session), and pane splitting (viewing multiple terminals side by side). For AI coding, tmux is the infrastructure that enables running multiple AI agents simultaneously with proper isolation.
HiveOS uses tmux as the backbone of its session management system. When you launch an AI coding session through HiveOS, it creates a dedicated tmux session with the appropriate project directory and environment. Each agent runs in its own isolated tmux session, preventing interference between agents. tmux's session persistence means agents continue running even if you close your terminal or lose your connection, which is essential for long-running AI tasks.
Beyond HiveOS integration, tmux is directly valuable for AI coding workflows. You can split your terminal into panes to see AI output alongside test results, log files, or server output. You can create multiple windows for different aspects of a task: one window for the AI agent, another for manual testing, and a third for monitoring. tmux's scriptability means you can automate session setup, creating complex multi-agent environments with a single command.
For developers new to tmux, the learning curve is modest but the productivity gains are significant. Key concepts include sessions (independent terminal environments), windows (tabs within a session), and panes (split views within a window). The prefix key (Ctrl+B by default) activates tmux commands, and a small set of shortcuts covers most daily usage.
Examples
- HiveOS creating a tmux session for each Claude Code instance it manages
- tmux allowing an AI agent to keep running even if you close your terminal
- Splitting tmux panes to see multiple AI agent outputs simultaneously
How tmux Works in AI Coding Tools
HiveOS creates and manages tmux sessions for each Claude Code instance, providing a visual management layer on top of tmux's terminal interface. You interact with sessions through HiveOS's dashboard rather than raw tmux commands, though direct tmux access is available when needed.
Claude Code runs within tmux sessions managed by HiveOS, benefiting from session persistence and isolation. Aider can be run in tmux sessions for persistent AI coding sessions that survive disconnection. Any terminal-based AI tool (Mentat, GPT-Engineer) can leverage tmux for session management and parallel execution.
Practical Tips
Learn the essential tmux shortcuts: Ctrl+B then D to detach, tmux attach to reconnect, Ctrl+B then C for new window, Ctrl+B then % for vertical split
Use HiveOS rather than raw tmux for managing AI coding sessions, as it provides visual monitoring and event tracking on top of tmux's session management
Configure tmux to increase the scrollback buffer (set-option -g history-limit 50000) for reviewing long AI agent output
Create a tmux configuration file (.tmux.conf) with your preferred settings so every AI coding session starts with a consistent, comfortable environment
Use tmux scripts to automate multi-agent setup: a single script can create sessions for each agent, set working directories, and launch AI tools in each session
FAQ
What is tmux?
A terminal multiplexer that lets you run and manage multiple terminal sessions within a single window.
Why is tmux important in AI coding?
tmux (terminal multiplexer) is a command-line tool that lets you create, manage, and switch between multiple terminal sessions within a single window. It provides session persistence (sessions survive disconnection), window management (multiple workspaces within a session), and pane splitting (viewing multiple terminals side by side). For AI coding, tmux is the infrastructure that enables running multiple AI agents simultaneously with proper isolation. HiveOS uses tmux as the backbone of its session management system. When you launch an AI coding session through HiveOS, it creates a dedicated tmux session with the appropriate project directory and environment. Each agent runs in its own isolated tmux session, preventing interference between agents. tmux's session persistence means agents continue running even if you close your terminal or lose your connection, which is essential for long-running AI tasks. Beyond HiveOS integration, tmux is directly valuable for AI coding workflows. You can split your terminal into panes to see AI output alongside test results, log files, or server output. You can create multiple windows for different aspects of a task: one window for the AI agent, another for manual testing, and a third for monitoring. tmux's scriptability means you can automate session setup, creating complex multi-agent environments with a single command. For developers new to tmux, the learning curve is modest but the productivity gains are significant. Key concepts include sessions (independent terminal environments), windows (tabs within a session), and panes (split views within a window). The prefix key (Ctrl+B by default) activates tmux commands, and a small set of shortcuts covers most daily usage.
How do I use tmux effectively?
Learn the essential tmux shortcuts: Ctrl+B then D to detach, tmux attach to reconnect, Ctrl+B then C for new window, Ctrl+B then % for vertical split Use HiveOS rather than raw tmux for managing AI coding sessions, as it provides visual monitoring and event tracking on top of tmux's session management Configure tmux to increase the scrollback buffer (set-option -g history-limit 50000) for reviewing long AI agent output
Sources & Methodology
Definitions are curated from practical AI coding usage, workflow context, and linked tool documentation where relevant.