Skip to main content

Maintenance and Debug CLI Scripts

This page covers operational scripts that are useful but easy to miss.

Dev Infra

Initialize local dev compose file (one-time):

npx @tradejs/cli infra-init

Start infra:

npx @tradejs/cli infra-up

Stop local infra:

npx @tradejs/cli infra-down

Cleanups

Clean local files under data/*:

npx @tradejs/cli clean-dir --dir cache
npx @tradejs/cli clean-dir --dir ml/export

Clean Redis area/prefix:

npx @tradejs/cli clean-redis --area cache
npx @tradejs/cli clean-redis --area users:root:tests:

Clean test keys for all users or one user:

npx @tradejs/cli clean-tests
npx @tradejs/cli clean-tests --user root
npx @tradejs/cli clean-tests --user root --cache

User Management

Create/update user in Redis:

npx @tradejs/cli user-add --user root --password 'secret'

Optional persistent token:

npx @tradejs/cli user-add --user root --password 'secret' --token '<token>'

Legacy History Migration

Migrate JSON candle files (data/history/*.json) to Timescale:

npx @tradejs/cli migration

Connector / Order Debug

Manual connector smoke script:

npx @tradejs/cli test-script

ML gRPC payload smoke script:

npx @tradejs/cli test-ml

Environment Health

npx @tradejs/cli doctor
npx @tradejs/cli doctor --require-ml
npx @tradejs/cli doctor --skip-ml