Doctor CLI

Usage

npx rakomi-doctor --base-url https://api.rakomi.com --api-key akm_live_xxx

What it checks

The doctor runs 4 checks in sequence:

#	Check	What it verifies
1	SDK version	Reports the installed @rakomi/node version
2	API reachable	GET /v1/health returns HTTP 200 within 10 seconds
3	JWKS available	GET /.well-known/jwks.json returns a valid key set
4	Token verification	SDK can initialize and process a token (infrastructure check)

Example output

@rakomi/node Doctor v0.1.0
================================

  ✓ SDK version: 0.1.0
  ✓ API reachable: https://api.rakomi.com/v1/health (42ms)
  ✓ JWKS available: 1 key(s) found
  ✓ Token verification: token/malformed (expected — no real token provided)

4/4 checks passed

Options

Option	Default	Description
--base-url	https://api.rakomi.com	Rakomi API URL
--api-key	akm_test_doctor_check	API key for verification check

Exit codes

Code	Meaning
0	All checks passed
1	One or more checks failed

When to use

Run the doctor when:

• Setting up a new integration
• Debugging connectivity issues
• After changing your API key or base URL
• Verifying that key rotation completed successfully