CLI

A cross-platform command-line tool for Riftbound. Browse cards, search the database, and play Riftboundle — all from your terminal.

Download

Platform	File
macOS (Apple Silicon)	riftscribe-darwin-arm64	Download →
macOS (Intel)	riftscribe-darwin-amd64	Download →
Linux x86_64	riftscribe-linux-amd64	Download →
Linux ARM64	riftscribe-linux-arm64	Download →
Windows	riftscribe-windows-amd64.exe	Download →

# macOS / Linux — make executable and move to PATH
chmod +x riftscribe-*
sudo mv riftscribe-* /usr/local/bin/riftscribe

Or build from source (requires Go 1.23+): cd cli && go build -o riftscribe .

All releases on GitHub →

Global Flags

--api-url <url>default: https://riftscribe.ggAPI base URL

-o, --output <format>default: prettyOutput format: pretty or json

# Pipe JSON output to jq
riftscribe cards list --set OGN -o json | jq '.[].name'

Commands

Cards

riftscribe cards list

List all cards

Flags

--set OGNFilter by set ID

--faction furyFilter by faction

--rarity rareFilter by rarity

-q "dragon"Search by name

--limit 20Max results (default 25)

--offset 0Pagination offset

Examples

riftscribe cards list
riftscribe cards list --set OGN --faction fury
riftscribe cards list -q "dragon" --rarity rare --limit 20

riftscribe cards search <query>

Fuzzy search cards by name

Flags

--limit 10Max results (default 10)

Examples

riftscribe cards search "blaze"
riftscribe cards search dragon --limit 5

riftscribe cards get <card-id>

Get full card details. Supports full ID (ogn-001-298) or short format (OGN-1).

Examples

riftscribe cards get ogn-001-298
riftscribe cards get OGN-1

riftscribe cards filters

Show all available filter values (sets, factions, rarities).

Examples

riftscribe cards filters

Riftboundle

riftscribe riftboundle today

Get today's puzzle info. Alias: rb today

Examples

riftscribe riftboundle today
riftscribe rb today

riftscribe riftboundle guess <card-id>

Submit a guess for the daily puzzle.

Flags

--puzzle <id>Puzzle ID (required)

--user <id>Your session ID (required)

Examples

riftscribe rb guess ogn-001-298 --puzzle 42 --user my-session-id

riftscribe riftboundle state

Check your current puzzle progress.

Flags

--puzzle <id>Puzzle ID (required)

--user <id>Your session ID (required)

Examples

riftscribe rb state --puzzle 42 --user my-session-id

Shell Completion

# Bash
riftscribe completion bash > /etc/bash_completion.d/riftscribe

# Zsh
riftscribe completion zsh > "${fpath[1]}/_riftscribe"

# Fish
riftscribe completion fish > ~/.config/fish/completions/riftscribe.fish