Set -o vi turns your Bash command-line into a vi-style editing environment, giving you familiar keybindings and navigation directly in the terminal.
This guide walks through how the setting behaves, why it matters for daily workflows, and how to manage history, completion, and debugging in vi mode.
| Mode | Insert Behavior | Navigation Behavior | History Search |
|---|---|---|---|
| Command Mode | Press i or a to enter insert | h/j/k/l move between characters/lines | / triggers reverse history search |
| Insert Behavior | Standard text insertion until Esc | Esc returns to command mode instantly | ? starts forward history search |
| Navigation Hotkeys | 0 to start of line, $ to end | w/b jump by words | Ctrl+R initiates reverse incremental search |
| Readline Vi Mode | Applies to Bash, Zsh, and other Readline-aware shells | Configurable via ~/.inputrc |
Emacs and vi modes can coexist per shell session |
Enabling Set -o Vi Mode
Activating vi editing mode is straightforward with set -o vi, which works in interactive Bash sessions by default in many distributions.
You can place the command in your ~/.bashrc to make the change persistent across logins and terminal launches.
Once enabled, you toggle between insert and command states using Esc, mirroring standard vi editor behavior.
Command Mode vs Insert Mode
Switching Between Modes
Command Mode lets you drive the shell with efficient key sequences, while Insert Mode functions like a traditional text editor for composing commands.
Learning the distinct responsibilities of each mode reduces mistakes and boosts speed when entering complex pipelines.
History and Search in Vi Mode
Reverse Search and History Expansion
Vi mode gives you rapid access to past commands through / reverse search and incremental history matching using Ctrl+R.
Understanding how history substitution interacts with your keystrokes helps you avoid accidental command reruns and keeps your workflow predictable.
Productivity Tips for Set -o Vi
Customizing Keybindings and Completion
Adjusting Readline variables and enabling programmable completion can sharpen your vi-based shell experience even further.
Combining useful shell options with mnemonic key sequences lets you build a personal editing style that scales across projects.
Mastering Set -o Vi for Daily Shell Work
- Enable vi mode with
set -o viin your shell startup files for persistent keyboard efficiency. - Practice quick toggles between insert and command modes to keep your typing rhythm intact.
- Leverage reverse history search with / and Ctrl+R to reuse complex commands safely.
- Customize key mappings and completions to align with your preferred vi workflows.
- Combine vi mode with shell aliases and functions for faster command construction and fewer keystrokes.
FAQ
Reader questions
Does set -o vi work in Zsh as well as Bash?
Yes, many Zsh configurations support vi mode, and you can enable it with bindkey -v and related options tailored to your setup.
Can I switch between vi and emacs mode on the same system?
Absolutely, you can toggle modes per shell session by running set -o vi or set -o emacs , and store your preference in shell configuration files.
Will enabling vi mode break existing keybindings or scripts?
Most standard keybindings remain intact, though complex custom macros may need adjustment when you change the editing mode.
How do I start a command with a prefix when using vi mode?
Use familiar vi motions such as 0 to jump to the beginning of the line or ^ to move to the first non-whitespace character before editing.