@nodots/backgammon-cli

Terminal client for Nodots Backgammon. Log in, play a game, and drive robot simulations from your shell.

Install

npm install -g @nodots/backgammon-cli

The binary is ndbg:

ndbg --help

Authentication

ndbg login opens a browser to authenticate via Auth0. Tokens are cached locally.

ndbg login
ndbg logout

Play a game

Start a human-vs-robot game, then roll and move:

ndbg human-vs-robot
ndbg game-roll
ndbg move <from> <to>
ndbg game-status

Drive a game turn-by-turn against the default robot:

ndbg game-play

Robot simulations

ndbg robot-list                      # show available robot configs
ndbg robot-simulate --count 10       # run one robot on N games
ndbg robot-batch --games 100         # batch simulation
ndbg robot-status <gameId>           # inspect a running robot's game
ndbg robot-board <gameId>            # render the current board

Control a running simulation:

ndbg robot-pause <gameId>
ndbg robot-stop  <gameId>
ndbg robot-speed <gameId> <ms>

Robot-vs-robot end-to-end:

ndbg robot-vs-robot

Requirements

• Node.js >= 20
• Network access to the Nodots Backgammon API (https://api.nodots.com)

Ecosystem

| Package | Role | | --- | --- | | @nodots/backgammon-types | Discriminated-union type contracts. | | @nodots/backgammon-core | Game logic. | | @nodots/backgammon-ai | GNU-backed robot move selection. | | @nodots/backgammon-api-utils | Request, response, and WebSocket contracts. | | @nodots/backgammon-cli | Terminal client (this package). | | @nodots/gnubg-hints | Native GNU Backgammon hints addon. |

Hosted product: backgammon.nodots.com.

License

GPL-3.0. See LICENSE.