CLI

The Lag CLI lets you access servers, voice rooms, and messages from your terminal. It includes a full TUI (terminal user interface) for interactive use and supports headless voice connections.

The CLI is open source and maintained separately at github.com/lag-app/cli.

Installation

Quick Install (macOS and Linux)

curl -fsSL https://raw.githubusercontent.com/lag-app/cli/main/install.sh | sh

This downloads the latest binary, installs it to ~/.lag/bin, and adds it to your PATH.

Homebrew (macOS and Linux)

brew tap lag-app/tap
brew install lag

Debian / Ubuntu

Download the latest .deb from the releases page and install it:

sudo dpkg -i lag_*.deb

Pre-built Binaries

Download the latest release for your platform from the Releases page.

Authentication

The CLI authenticates through your browser:

lag login

This opens your default browser to the Lag login page. After you sign in with Discord or Google, the browser redirects back and the CLI receives your authentication token.

To check who you are logged in as:

lag whoami

To log out and remove stored credentials:

lag logout

Available Commands

Command	Description
lag login	Authenticate via browser
lag logout	Clear credentials
lag whoami	Show current user
lag setup	Audio setup wizard
lag servers	List your servers
lag servers <name>	Show server details
lag friends	List friends
lag friends add <username>	Send a friend request
lag friends requests	View pending requests
lag friends accept <username>	Accept a friend request
lag dms	List DM conversations
lag dms open <username>	Interactive DM session
lag dms send <username> <msg>	Send a one-off DM
lag chat open <server> <room>	Interactive room chat
lag chat send <server> <room> <msg>	Send a message to a room
lag join <server> <room>	Join a voice room (headless)
lag audio	Show audio config
lag audio devices	List audio devices
lag audio test	Record and playback test
lag status [online\|idle]	Set or show your status
lag ui	Launch the full TUI

TUI

The TUI mode provides a full interactive interface in your terminal. Launch it with lag ui.

The TUI layout mirrors the main app: servers on the left, rooms in the middle, and content on the right.

Configuration

View and modify configuration with the lag config commands:

lag config                       # Show current config
lag config set <key> <value>     # Set a config value
lag config reset                 # Reset to defaults

To point the CLI at a custom API endpoint:

lag config set api-url https://your-api-url.com

Requirements

macOS or Linux. Push-to-talk requires Input Monitoring permission on macOS (System Settings > Privacy & Security > Input Monitoring).