CLI - Meridian

meridian-cli is a command-line tool for inspecting and debugging Meridian namespaces without opening a browser.

Installation

bun add -g meridian-cli
# or
npm install -g meridian-cli

Or run directly with bunx:

bunx meridian-cli inspect my-ns gc:views --url http://localhost:3000 --token $TOKEN

Commands

`meridian inspect <namespace> <crdt-id>`

Prints the current state of a CRDT as JSON.

meridian inspect my-ns gc:views \
  --url http://localhost:3000 \
  --token $TOKEN

{
  "type": "gcounter",
  "value": 42,
  "counts": { "1": 30, "2": 12 }
}

`meridian replay <namespace> <crdt-id>`

Streams WAL history entries for a CRDT, one line per op.

meridian replay my-ns gc:views \
  --url http://localhost:3000 \
  --token $TOKEN \
  --from-seq 0 \
  --limit 50

seq        timestamp              op
────────────────────────────────────────────────────────────────────────
#1         2025-03-22T10:00:01Z  {"Increment":{"client_id":1,"delta":1}}
#2         2025-03-22T10:00:04Z  {"Increment":{"client_id":2,"delta":1}}
...
Done.

Pagination is handled automatically — the command fetches pages until there are no more entries.

Options

Option	Alias	Default	Description
`--url`	`-u`	`http://localhost:3000`	Meridian server base URL
`--token`	`-t`	—	Bearer token
`--from-seq`	—	`0`	Start sequence number (`replay` only)
`--limit`	—	`50`	Entries per page (`replay` only)