Boost Your Terminal Productivity: Master Tmux and Vim Integration

Introduction

Many developers spend a lot of time in terminal consoles, opening many tabs. This article introduces Tmux, explains its basic concepts, and shows how to combine it with Vim to create a more efficient and elegant terminal workflow.

Contents

Tmux basics

Best features of Tmux

Window

Pane

Session

Fast cursor movement and text copying

Lightweight pair‑programming features

Adjusting Tmux for better Vim integration

Background color scheme

Cursor shape

Paste indentation handling

Other tools and tricks

Tmuxinator for automatic session creation

Changing the status‑bar colors

The author tested with the following software versions:

Tmux 1.9a

Vim 7.4

iTerm 2.1

macOS Mavericks and Yosemite

What Is Tmux?

Tmux is a terminal multiplexer that lets you run multiple terminal sessions inside a single window, detach and reattach sessions, and manage them in the background.

Example session layout:

Left: Vim

Right: System shell

Bottom‑left: Tmux session name (e.g., “pomodoro‑app”)

Bottom‑center: Windows within the session (e.g., “app log”, “editor”, “shell”)

Bottom‑right: Current date

Installation

macOS

Install Homebrew:

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Then install Tmux:

$ brew install tmux

Ubuntu

Run:

$ sudo apt-get install tmux

Prefix (Shortcut) Key

Tmux uses a prefix (default Ctrl‑b) to avoid conflicts with other programs. To list sessions, press Ctrl‑b s. To change the prefix to Ctrl‑a, add to ~/.tmux.conf:

unbind C-b
set -g prefix C-a

Configuration File

Tmux reads ~/.tmux.conf on startup. To reload the config without restarting a session, bind a key (e.g., Ctrl‑b r) with:

# bind a reload keybind R source-file ~/.tmux.conf \; display-message "Config reloaded.."

Key Features

Panes

Split vertically with Ctrl‑b % and horizontally with Ctrl‑b ". Move between panes using the prefix followed by arrow keys.

Windows

Windows are containers for panes. Create a new window with Ctrl‑b c and switch with Ctrl‑b followed by the window number.

Sessions

A session can hold multiple windows. Create a new session: $ tmux new -s <session-name> List sessions with Ctrl‑b s and attach to an existing one with:

$ tmux attach

Fast Text Navigation and Copying

Enable Vim‑style keybindings in copy mode by adding to ~/.tmux.conf:

# Use vim keybindings in copy mode
set -g mode-keys vi

Copy text with Ctrl‑b [ to enter copy mode, move with h j k l, start selection with Space, and confirm with Enter. To send copied text to the system clipboard on macOS, install reattach-to-user-namespace and add:

# invoke reattach-to-user-namespace every time a new window/pane opens
set-option -g default-command "reattach-to-user-namespace -l bash"

# copy selected text to the system clipboard
bind-key -t vi-copy y copy-pipe "reattach-to-user-namespace pbcopy"

Pair Programming with Tmate

Tmate shares a Tmux session over SSH. Install: $ brew install tmate Start a session with tmate and share the generated SSH URL.

Improving Vim Integration

Background Color Scheme

Set the terminal type for proper colors:

if exists('$TMUX')
  set term=screen-256color
endif

Cursor Shape

Update ~/.vimrc to let iTerm change the cursor based on mode:

if exists('$ITERM_PROFILE')
  if exists('$TMUX')
    let &t_SI = "\<Esc>[3 q"
    let &t_EI = "\<Esc>[0 q"
  else
    let &t_SI = "\<Esc>]50;CursorShape=1\x7"
    let &t_EI = "\<Esc>]50;CursorShape=0\x7"
  endif
endif

Paste Indentation

Prevent automatic indentation when pasting into Vim:

" for tmux to automatically set paste and nopaste mode at the time pasting (as" happens in VIM UI)
function! WrapForTmux(s)
  if !exists('$TMUX')
    return a:s
  endif
  let tmux_start = "\<Esc>Ptmux;"
  let tmux_end = "\<Esc>\\"
  return tmux_start . substitute(a:s, "\<Esc>", "\<Esc>\<Esc>", 'g') . tmux_end
endfunction
let &t_SI .= WrapForTmux("\<Esc>[?2004h")
let &t_EI .= WrapForTmux("\<Esc>[?2004l")
function! XTermPasteBegin()
  set pastetoggle="\<Esc>[201~"
  set paste
  return ""
endfunction
inoremap <special> <expr> \<Esc>[200~ XTermPasteBegin()

Tmuxinator – Automatic Session Creation

Install the Ruby gem: $ gem install tmuxinator Create a project configuration: $ tmuxinator new project_a Edit ~/.tmuxinator/project_a.yml to define windows and panes, then start with:

$ tmuxinator start project_a

Customizing the Status Bar

Example configuration added to ~/.tmux.conf to change colors and layout:

# Status bar
set -g status-bg black
set -g status-fg white
set-option -g status-justify centre
set-option -g status-left '#[bg=black,fg=green][#[fg=cyan]#S#[fg=green]]'
set-option -g status-left-length 20
setw -g automatic-rename on
set-window-option -g window-status-format '#[dim]#I:#[default]#W#[fg=grey,dim]'
set-window-option -g window-status-current-format '#[fg=cyan,bold]#I#[fg=blue]:#[fg=cyan]#W#[fg=dim]'
set -g status-right '#[fg=green][#[fg=cyan]%Y-%m-%d#[fg=green]]'

Conclusion

The article covered Tmux fundamentals, its most useful features, configuration tips for tighter Vim integration, and additional tools like Tmuxinator and status‑bar theming. Readers are encouraged to try the techniques and share any other useful configurations.