BetterDiscord CLI

A cross-platform command-line interface for installing, updating, and managing BetterDiscord.

Features

• 🚀 Easy installation and uninstallation of BetterDiscord
• 🔄 Support for multiple Discord channels (Stable, PTB, Canary)
• 🧭 Discover Discord installs and suggested paths
• 🧩 Manage plugins and themes (list, install, update, remove)
• 🛒 Browse and search the BetterDiscord store
• 🖥️ Cross-platform support (Windows, macOS, Linux)
• 📦 Available via npm for easy distribution
• ⚡ Fast and lightweight Go binary

Installation

Via npm (Recommended)

npm install -g @betterdiscord/cli

Via Go

go install github.com/betterdiscord/cli@latest

Via winget (Windows)

winget install betterdiscord.cli

Via Homebrew/Linuxbrew

brew install betterdiscord/tap/bdcli

Download Binary

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

Usage

Global Options

bdcli --silent <command>   # Suppress non-error output

You can also set BDCLI_SILENT=1 to silence output in automation.

Install BetterDiscord

Install BetterDiscord to a specific Discord channel:

bdcli install --channel stable   # Install to Discord Stable
bdcli install --channel ptb      # Install to Discord PTB
bdcli install --channel canary   # Install to Discord Canary

Install BetterDiscord by providing a Discord install path:

bdcli install --path /path/to/Discord

Uninstall BetterDiscord

Uninstall BetterDiscord from a specific Discord channel:

bdcli uninstall --channel stable   # Uninstall from Discord Stable
bdcli uninstall --channel ptb      # Uninstall from Discord PTB
bdcli uninstall --channel canary   # Uninstall from Discord Canary

Uninstall BetterDiscord by providing a Discord install path:

bdcli uninstall --path /path/to/Discord

Uninject BetterDiscord from all detected Discord installations (without deleting data):

bdcli uninstall --all

Fully uninstall BetterDiscord from all Discord installations and remove all BetterDiscord folders:

bdcli uninstall --full

Check Version

bdcli version

Update BetterDiscord

bdcli update
bdcli update --check

Show BetterDiscord Info

bdcli info

Discover Discord Installs

bdcli discover installs
bdcli discover paths
bdcli discover addons

Manage Plugins

bdcli plugins list
bdcli plugins info <name>
bdcli plugins install <name|id|url>
bdcli plugins update <name|id|url>
bdcli plugins update <name|id> --check    # Check for updates without installing
bdcli plugins remove <name|id>

Manage Themes

bdcli themes list
bdcli themes info <name>
bdcli themes install <name|id|url>
bdcli themes update <name|id|url>
bdcli themes update <name|id> --check     # Check for updates without installing
bdcli themes remove <name|id>

Browse the Store

bdcli store search <query>
bdcli store show <id|name>

bdcli store plugins search <query>
bdcli store plugins show <id|name>

bdcli store themes search <query>
bdcli store themes show <id|name>

Shell Completions

bdcli completion bash
bdcli completion zsh
bdcli completion fish

Help

bdcli --help
bdcli [command] --help

Automation

For scripts and CI jobs, you can suppress non-error output:

# One-off command
bdcli --silent install --channel stable

# Environment variable (applies to all commands)
BDCLI_SILENT=1 bdcli update

CLI Help Output

A cross-platform CLI for installing, updating, and managing BetterDiscord.

Usage:
   bdcli [flags]
   bdcli [command]

Available Commands:
   completion  Generate shell completions
   discover    Discover Discord installations and related data
   help        Help about any command
   info        Displays information about BetterDiscord installation
   install     Installs BetterDiscord to your Discord
   plugins     Manage BetterDiscord plugins
   store       Browse and search the BetterDiscord store
   themes      Manage BetterDiscord themes
   uninstall   Uninstalls BetterDiscord from your Discord
   update      Update BetterDiscord to the latest version
   version     Print the version number

Flags:
       --silent   Suppress non-error output
   -h, --help     help for bdcli

Use "bdcli [command] --help" for more information about a command.

Supported Platforms

• Windows (x64, ARM64, x86)
• macOS (x64, ARM64/M1/M2)
• Linux (x64, ARM64, ARM)

Development

Prerequisites

• Go 1.26 or higher
• Task (optional, for task automation)
• GoReleaser (for releases)

Setup

Clone the repository and install dependencies:

git clone https://github.com/BetterDiscord/cli.git
cd cli
task setup  # Or: go mod download

Available Tasks

Run task --list-all to see all available tasks:

# Development
task run             # Run the CLI (pass args with: task run -- install stable)

# Building
task build           # Build for current platform
task build:all       # Build for all platforms (GoReleaser)

# Testing
task test            # Run tests
task test:verbose    # Run tests with verbose output
task coverage        # Run tests with coverage summary
task coverage:html   # Generate HTML coverage report

# Code Quality
task fmt             # Format Go files
task vet             # Run go vet
task lint            # Run golangci-lint
task check           # Run fix, fmt, vet, lint, test

# Release
task release:snapshot # Test release build
task release          # Create release (requires tag)

# Cleaning
task clean           # Remove build and debug artifacts

Running Locally

# Run directly
go run main.go install stable

# Or use Task
task run -- install stable

Building

# Build for current platform
task build

# Build for all platforms
task build:all

# Output will be in ./dist/

Testing

# Run all tests
task test

# Run with coverage
task coverage

Releasing

1. Create and push a new tag:

   git tag -a v0.2.0 -m "Release v0.2.0"
   git push origin v0.2.0

2. GitHub Actions will automatically build and create a draft release

3. Edit the release notes and publish

4. Publish to npm:

   npm publish

Project Structure

.
├── cmd/                  # Cobra commands
│   ├── install.go       # Install command
│   ├── update.go        # Update command
│   ├── info.go          # Info command
│   ├── discover.go      # Discover command
│   ├── plugins.go       # Plugins commands
│   ├── themes.go        # Themes commands
│   ├── store.go         # Store commands
│   ├── uninstall.go     # Uninstall command
│   ├── version.go       # Version command
│   └── root.go          # Root command
├── internal/            # Internal packages
│   ├── betterdiscord/  # BetterDiscord installation logic
│   ├── discord/        # Discord path resolution and injection
│   ├── models/         # Data models
│   └── utils/          # Utility functions
├── main.go             # Entry point
├── Taskfile.yml        # Task automation
└── .goreleaser.yaml    # Release configuration

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'feat: add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Links

• BetterDiscord Website
• BetterDiscord Documentation
• Issue Tracker
• npm Package

Acknowledgments

Built with:

• Cobra - CLI framework
• GoReleaser - Release automation
• Task - Task runner

Made with ❤️ by the BetterDiscord Team