CLI Quickstart

Install the MeepaChat CLI and start using it in minutes

The meepachat CLI lets you interact with your MeepaChat instance from the terminal: manage servers, send messages, create bots, and more.

Installation

The CLI is a standalone binary, separate from the MeepaChat server.

curl

curl -fsSL https://meepachat.bogpad.io/install-cli.sh | sh

Detects your OS and architecture, downloads the latest release, verifies the checksum, and installs to /usr/local/bin/meepachat.

Homebrew

brew install bogpad/tap/meepachat-cli

Works on macOS and Linux. Updates via brew upgrade.

Manual download

Download the latest release for your platform from the GitHub releases page. Archives are named meepachat-cli_VERSION_OS_ARCH.tar.gz.

# Example: Linux amd64
curl -L https://github.com/bogpad/meepachat/releases/latest/download/meepachat-cli_0.1.0_linux_amd64.tar.gz -o meepachat-cli.tar.gz
tar xzf meepachat-cli.tar.gz
sudo mv meepachat /usr/local/bin/

Verify the installation:

meepachat version

Log in

Browser login (default)

Opens your browser for OAuth authentication. The token is saved automatically.

meepachat --url https://chat.example.com login

Email/password

For instances with direct login enabled. Interactive prompts:

meepachat --url https://chat.example.com login --no-browser

Non-interactive (useful in scripts):

meepachat --url https://chat.example.com login --email [e-mail] --password s3cr3t

Token

Save a token directly (skips interactive login):

# Session token
meepachat --url https://chat.example.com login --token YOUR_TOKEN

# Bot token (id.secret format)
meepachat --url https://chat.example.com login --token BOT_ID.SECRET --bot

After login, the URL and token are written to ~/.config/meepachat/config.json — you won’t need --url or --token on subsequent commands.

Verify

meepachat auth me

ID            42
Username      alice
Display Name  Alice
Bot           false

Basic usage

List your servers

meepachat servers list

ID   Name          Role
1    Engineering   owner
2    Design        member

List channels in a server

meepachat channels list --server 1

ID   Name      Visibility   Topic
10   general   public       Welcome to Engineering
11   random    public

Send a message

meepachat messages send "Hello from the CLI!" --server 1 --channel 10

Read recent messages

meepachat messages list --server 1 --channel 10 --limit 5

Search messages

meepachat search "deploy" --server 1

Get JSON output

Add --json to any command for machine-readable output, useful for scripting with jq:

meepachat servers list --json | jq '.[].name'

Log out

meepachat logout

Clears the token from ~/.config/meepachat/config.json while preserving the instance URL.

Next steps

Command Reference

Every command, subcommand, and flag

Configuration

Config file, environment variables, shell completion