bitbard

A general-purpose CLI tool. Currently supports audio controls, display controls, VPN management, and more.

Table of Contents

• Installing and Upgrading
  • Install Script
  • Verify Installation
  • Upgrading
  • Uninstalling
• Commands
  • audio
  • display
  • spotify
  • system
  • vpn

Installing and Upgrading

Install Script

To install or update bitbard, run the install script:

curl -fsSL https://raw.githubusercontent.com/geersch/bitbard-cli/master/install.sh | bash

Verify Installation

Open a new terminal (or reload your shell profile) and run:

bitbard --help

If you get command not found, make sure ~/.local/bin is on your PATH:

export PATH="$HOME/.local/bin:$PATH"

Add that line to your ~/.zshrc or ~/.bashrc to make it permanent.

Upgrading

Use the built-in upgrade command:

bitbard upgrade

Or re-run the install script:

curl -fsSL https://raw.githubusercontent.com/geersch/bitbard-cli/master/install.sh | bash

Uninstalling

Run these commands to fully remove bitbard:

# Stop and remove the background daemon
launchctl unload ~/Library/LaunchAgents/com.bitbard.bitbardd.plist
rm ~/Library/LaunchAgents/com.bitbard.bitbardd.plist

# Remove installed binaries
rm ~/.local/share/bitbard/bin/bitbardd
rm ~/.local/bin/bitbard

# Optional: remove config and state
rm -rf ~/.config/bitbard

Then remove the export PATH line added by the installer from your shell config file (e.g. ~/.zshrc).

Commands

Command	Description
audio	Audio device commands
display	Display-related commands
spotify	Control the Spotify application
system	System-related commands
vpn	VPN management commands