cli

@randsum/cli

A Zero Dependency, Typescript-First, Bun-Native Dice Notation and Rolling Engine

Throw Dice, Not Exceptions.

Dice rolling CLI and interactive TUI powered by RANDSUM.

Powered by @randsum/roller — RDN v1.0 Level 4 (Full) Conformant

Install

npm install -g @randsum/cli
# or
bunx randsum
# or
npx randsum

Usage

Quick Roll

randsum 4d6L          # Roll 4d6, drop lowest
randsum 2d20H         # Disadvantage (drop highest)
randsum 1d20+5        # Attack roll with modifier
randsum 3d6!          # Exploding dice

Interactive TUI

randsum               # Launch interactive mode
randsum -i            # Explicit interactive flag

Options

-i, --interactive     Launch interactive TUI mode
-v, --verbose         Show detailed roll breakdown
--json                Output results as JSON
-r, --repeat N        Roll N times (default: 1)
-s, --seed <number>   Set random seed for reproducible rolls
-V, --version         Show version
-h, --help            Show help

Dice Notation

Uses RANDSUM Dice Notation — supports drop/keep (L/H), reroll (R{}), exploding (!), unique (U), cap (C{}), and arithmetic (+/-).

License

MIT