Dice rolling CLI powered by RANDSUM.

Powered by @randsum/roller — RDN v0.9.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

Options

-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

Notation can also be piped in via stdin:

echo "4d6L" | randsum

Dice Notation

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

How it ships

A plain string-formatting CLI — no interactive UI. @randsum/roller is bundled into a single ESM dist/index.js at build time (bunup, noExternal: /^@randsum\//), so the published package has zero runtime dependencies.

License

MIT