Package Exports

@randsum/cli
@randsum/cli/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@randsum/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@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.

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