Usage

You’ve installed and initialized. Here’s how to launch the proxy and monitor your savings.

Launch Claude Code through the proxy

notdiamond claude        # launch Claude Code with routing enabled
nd claude                # shorter alias (same as above)

The proxy intercepts the request, routes it to the optimal model tier, and forwards it to Claude Code.

Run the proxy standalone

If you want the proxy running in the background for multiple Claude Code sessions:

notdiamond start         # start daemon in background; logs to ~/.notdiamond/proxy.log
notdiamond start -f      # start in foreground (useful for debugging; Ctrl+C to stop)

To stop or restart:

notdiamond stop          # graceful shutdown (SIGTERM, then SIGKILL after 2s if needed)
notdiamond restart       # stop + start in one command

Monitor and inspect

While the proxy runs, inspect its state and behavior:

notdiamond status        # show uptime, total requests, errors, and provider
notdiamond logs -f       # tail recent requests (follow mode; press Ctrl+C to exit)
notdiamond doctor        # health check: validates config, auth, port, cloud connectivity

The status output shows something like:

notdiamond proxy status
  uptime:        142s
  total req:     38
  errors:        0
  provider:      anthropic (…abc1)

View your savings

For detailed breakdowns - tier distribution, per-request routing decisions, and cost trends - visit the Not Diamond dashboard. Log in with the same credentials you used for notdiamond init.

Managing your login

Your auth token lasts 60 days. You can check and refresh it:

notdiamond whoami        # show current user and token expiry date
notdiamond login         # re-authenticate (device-code flow, opens browser)
notdiamond logout        # sign out and remove the token from ~/.notdiamond/auth.json

If your token expires, the proxy will refuse to start and tell you to run notdiamond login.