of the brand new issues I’ve come throughout lately, whereas researching command-line-based coding assistants, is the point out and use of a software I hadn’t heard of earlier than. That software known as Tmux, which stands for Terminal Multiplexer.
Within the easiest doable phrases, Tmux permits you to cut up up a single terminal window into a variety of separate home windows and panes, every of which is a terminal in its personal proper. Adoption of instruments like Tmux has surged, largely because of the agent crew workflows present in command-line coding agent merchandise like Claude Code. I point out Claude Code right here, however all of its essential rivals, resembling Google’s Gemini CLI and OpenAI’s Codex, both have already got or will probably be engaged on their very own equivalents.
The purpose is that, in instruments like Claude Code, when it creates a number of brokers to hold out work, it could assign every agent to its personal window pane. These visible clues make it a lot, a lot simpler ( for people) to maintain monitor of what’s going on as your agentic workloads progress.
Claude Code will spin up as many separate terminal window panes as wanted, assign every agent a pane, and robotically shut every pane because the agent completes its work. And in lots of circumstances, it’s utilizing Tmux for this terminal administration.
Because it’s possible that an increasing number of workloads sooner or later will probably be carried out with a number of brokers, you’ll most likely see and use Tmux extra usually. So, I believe it is sensible to study a bit extra about what Tmux is and what it could do exterior of simply coding platforms. For the remainder of this text, I’ll clarify easy methods to obtain Tmux and present some typical operations you are able to do with it. I’m solely going to cowl an important ideas and can add a hyperlink to the Tmux GitHub dwelling web page on the finish so you’ll be able to dive deeper in order for you.
Observe: apart from being a consumer of them, I’ve no affiliation or affiliation with any of the merchandise or firms talked about on this article
Tmux Licensing
Tmux is open supply and utterly free to make use of. Every supply code file within the repo has the next licence connected.
Permission to make use of, copy, modify, and distribute this software program for any function with or with out price is hereby granted, supplied that the above copyright discover and this permission discover seem in all copies.
THE SOFTWARE IS PROVIDED “AS IS” AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF MIND, USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
Putting in Tmux
Relying in your working system, you’ll be able to set up Tmux in one of many methods beneath.
macOS The best approach to set up tmux on macOS is by way of Homebrew. Open your terminal and run:
brew set up tmux
Ubuntu / Debian / Linux Mint
On Debian-based distributions, use the apt package deal supervisor:
sudo apt replace
sudo apt set up tmux
Fedora / CentOS / RHEL
For distributions utilizing dnf or yum:
sudo dnf set up tmux
Home windows
I’m a Home windows consumer, however sadly, Home windows doesn’t help Tmux natively however you can run it by way of the Home windows Subsystem for Linux (WSL). To do this,
- Set up a WSL Linux distribution (like Ubuntu) from the Microsoft Retailer.
- Open the WSL terminal.
- Use the Ubuntu command: sudo apt set up tmux.
Key Tmux phrases you need to perceive
These are the foundational concepts of tmux, and nearly every part else builds on them.
- Periods. Persistent workspaces that survive disconnects. You’ll be able to detach and reattach later.
- Home windows: These are your digital desktops. You might need one window devoted to “Coding” and one other for debugging.
- Panes. Sub-windows inside a window. They are often oriented both vertically or horizontally. Every pane is a mini command-line terminal in its personal proper.
One of many key benefits of Tmux is which you could connect and detach periods. Whenever you detach a session, no matter it’s operating will stay operating within the background, and whenever you re-attach to the session, you’ll see the up to date state of regardless of the session was already doing.
Verifying your Set up
As soon as the set up is full, you’ll be able to confirm that it’s working by checking the model:
$ tmux -V
tmux 3.2a
Beginning a Tmux session
The “hiya world” of utilizing Tmux is solely beginning a session.
$ tmux
Nothing a lot will change, however you’ll discover a inexperienced standing bar seem on the backside of your terminal window, indicating that you’re now inside a tmux session. You’ll be able to kind in common working system instructions from right here. For instance listing all my directories,

Inside a Tmux window or pane, you’ll be able to listing all of your periods utilizing the command:
$ tmux ls
0: 3 home windows (created Tue Feb 10 18:22:12 2026)
2: 1 home windows (created Tue Feb 10 19:11:12 2026)
3: 1 home windows (created Wed Feb 11 10:42:16 2026) (connected)
session2: 2 home windows (created Tue Feb 10 18:29:23 2026)
To kill periods, kind one of many following,
# To kill a selected session:
$ tmux kill-session -t [session_name_or_number]
# Or ... to kill EVERY session (The "Nuke" possibility):
$ tmux kill-server
Executing Tmux built-in instructions
Tmux depends on a “prefix” key mixture to execute its built-in instructions. By default, that is Ctrl + b, adopted normally by a single character. Listed here are some examples of widespread instructions you’ll use usually.
Motion Command
------- -------------------------
Break up display screen vertically Ctrl + b then %
Break up display screen horizontally Ctrl + b then """
Transfer to a different pane Ctrl + b then Arrow Keys
Kill present window Ctrl+b then &
Exit tmux Ctrl + then d
Instance 1 – Creating new panes
So, having began a Tmux session as above, attempt typing Ctrl+b adopted by the per cent character (%) to separate your authentic window vertically into two panes. You must see one thing like this.

Now kind Ctrl+b adopted by the double quote (“) character, and you need to see that the brand new pane has now been cut up horizontally like this,

Observe that the “title” of your present window is at all times displayed within the standing bar on the backside of the display screen. By default, these are merely numbered sequentially ranging from 0, however you’ll be able to rename them in order for you.
To shut down the energetic pane, kind the command Ctrl+b adopted by the x character. On the standing bar, you’ll see a immediate asking you to verify the operation.
Instance 2 – Creating new Home windows
To create a brand new window, kind Ctrl+b adopted by the character c. The brand new window will overlay and obscure any current Tmux home windows you’ve got displayed. However have a look at the standing bar, and you will note it shows all of your window names. To change between completely different home windows, use the keyboard shortcut Ctrl+b adopted by the n (or p) character to go to the subsequent (or earlier) window. You too can change to a selected window quantity by typing its quantity in as a substitute of n (or p)
To shut down a window, kind the Ctrl+b command adopted by the ampersand (&) character. The standing bar will show a immediate asking you to verify the operation.
Instance 3 – Transferring between panes and enabling the mouse
Okay, you created a bunch of panes inside a window. Say you want to transfer between them. By the way, notice that your present pane is bordered in inexperienced, so that you at all times know which one has focus.
There are two methods to do that. Through the keyboard, you’ll be able to kind Ctrl+b adopted by an acceptable arrow key. Observe that you should key on this sequence each time you need to transfer panes.
Utilizing the keyboard like this on a regular basis to maneuver round can turn into tiresome, however there’s a manner to make use of the mouse as a substitute. To allow the mouse, you’ll be able to kind Ctrl+b adopted by the colon (:) character. The underside bar of your display screen ought to flip a distinct color, and also you’ll see a colon immediate. Kind within the following,
: set -g mouse on
After that, you need to be capable to change between panes together with your mouse simply by left-clicking on them. You probably have a number of home windows open, you can even transfer between them by left-clicking on the suitable window title in your standing bar.
Instance 4 – The Tmux configuration file
The way in which we arrange the mouse within the earlier instance was finished on a per-session foundation. This implies once we shut down Tmux and re-open it, the mouse setting will probably be gone. To keep away from having to arrange issues like this each time you begin Tmux, you’ll be able to put them in a configuration file in your house listing referred to as .tmux.conf. Like this,
echo "set -g mouse on" > ~/.ftmux.conf
To use the change instantly with out restarting Tmux, run this inside a Tmux terminal:
Ctrl + b then : then kind source-file ~/.tmux.conf.
In any other case, the subsequent time Tmux begins, it robotically seems to be to your configuration file and makes use of it if current.
There’s a bunch of different settings you’ll be able to put in your configuration file, so I recommend you verify the Tmux doc hyperlink on the finish for a full listing.
Instance 5- Detaching a session
That is the superpower of Tmux, however there’s not quite a bit to it actually. You can begin a course of (like an enormous obtain), “detach” from it, shut your terminal app, and it retains operating within the background, able to be displayed whenever you re-attach to it. To detach a session, kind Ctrl+b adopted by the character d. As soon as a session is indifferent, you re-attach by typing this into any common terminal command window:
$ tmux connect
Instance 6- Creating your individual Ctrl+b instructions
To create customized Ctrl+b instructions, use the Tmux bind command. For instance, suppose you need to create a shortcut key sequence to allow mouse help everytime you kind Ctrl+b adopted by the m character. Kind the next instructions in,
# get to the command line on the standing bar first
Ctrl+b :
# Now map urgent Ctrl+b m to show the mouse ON
bind m set -g mouse on ; show 'Mouse: ON'
Once more, this is able to activate the mouse ON key mapping for the present session solely. To make it obtainable in each Tmux session, place the bind command within the .tmux.conf file.
echo "bind m set -g mouse on ; show 'Mouse: ON'" >> .tmux.conf
Instance 7- Miscellaneous ideas
- Resizing a pane. Assuming you’ve got the mouse enabled, to resize a pane, merely left-click on its border with one other pane and drag left-right or up-down as required. If the mouse shouldn’t be enabled, kind Ctrl+b, then maintain down the ALT key while urgent one of many arrow keys.
- Getting assist. Show all Ctrl-b instructions by typing Ctrl+b adopted by the query mark (?) character. To exit this show, kind the c or ESC key
- Zooming in. You probably have a number of panes open, urgent Ctrl+b adopted by the z character will make the present, energetic pane fill the entire window. Urgent the identical key mixture once more will restore issues to the way in which they have been.
- The “The place Am I?” Flash. You probably have a display screen stuffed with panes and also you lose monitor of which is which, press Ctrl+b then q. Giant numbers will flash over each pane. Not solely does this present you the variety of every pane, however in the event you kind the quantity whereas it’s displayed, you’ll immediately bounce to that pane and make it energetic.
- Switching pane positions. To swap pane positions, click on Ctrl+b adopted by both an open or closed curly brace character ({}). This may alternate the situation of the energetic pane with one other pane within the window.
Abstract
I believe attending to know and utilizing a utility like Tmux is an effective addition to have in your developer toolbox. That is bolstered by the truth that we’re beginning to see many code assistant instruments, resembling Claude Code, actively utilizing instruments like Tmux to show the progress of multi-agent processes. As command-line agentic improvement workflows flourish, we’ll see extra of the sort of use case.
This text has solely scratched the floor of what the Tmux utility is able to. Instruments like this will take appreciable time to turn into actually proficient with, however I believe it’s worthwhile to persevere. Should you do, you may look again and marvel the way you coped with out it.
To seek out out extra about Tmux, go to its GitHub web page on the following hyperlink:

