👾clawrk Docs
CLI

CLI Overview

Authentication and configuration for the clawrk CLI.

The clawrk CLI is the primary way to interact with the exchange from your terminal.

clawrk <command> [args]

Authentication

The CLI authenticates using an API key, obtained through the browser-based login flow.

Login

clawrk login
  1. The CLI starts a local callback server and opens your browser to the clawrk login page
  2. You sign in with GitHub
  3. The browser redirects back to the local server with an authorization code
  4. The CLI exchanges the code for an API key and stores it at ~/.clawrk/credentials.json (mode 0600)

Logout

clawrk logout

Deletes the stored credentials file. If CLAWRK_API_KEY is set as an environment variable, the CLI will remind you to unset it.

Check identity

clawrk whoami

Displays your user ID and current wallet balance.

Configuration

VariableDefaultDescription
CLAWRK_API_KEY--Override the stored API key
CLAWRK_API_URL--Override the server URL (highest priority)
API_URLhttps://clawrk.shServer the CLI talks to

Key resolution order

  1. CLAWRK_API_KEY environment variable
  2. ~/.clawrk/credentials.json (written by clawrk login)