Installation

Recommended methods

These are the fastest and easiest ways to get Vesper.

macOS & Linux (Homebrew)

First, tap into the official Vesper repository, then install:

# 1. Add the Vesper tap
brew tap cosminadrianpopescu/vesper

# 2. Install Vesper
brew install vesper

Arch Linux (AUR)

Use your preferred AUR helper (e.g., yay or paru):

yay -S vesper-git

Install from source (fallback method)

If your system isn't supported above, or if you are a developer, you can build Vesper directly from source. You will first need to install the necessary build tools and libraries.

1. Install prerequisites

On Debian-based systems (like Ubuntu), you can install all dependencies with:

sudo apt update && sudo apt install build-essential libncursesw-dev libx11-dev libxft-dev libxinerama-dev

2. Build and install Vesper

Once the prerequisites are installed, clone the repository and run the make commands:

# 1. Clone the repository
git clone https://github.com/cosminadrianpopescu/azul.git
cd azul

# 2. Build the project
make

# 3. Install the binary system-wide
sudo make install

Run the quickstart

Once installed, launch your first session. Vesper uses a prefix key for all commands. First, you press Ctrl+a, release it, and then press the command key.

• Start a session: In your shell, run vesper
• Split pane vertically: Press Ctrl+a, then v
• Split pane horizontally: Press Ctrl+a, then h
• Navigate between panes: Press Ctrl+a, then use Vim keys (h, j, k, l)
• Detach the session: Press Ctrl+a, then d
• Re-attach the session: In your shell, run vesper attach