Install & Login

The CLI is published to npm and runs on Node.js 20 or later.

Install

Run directly with npx (recommended)

npx clawnify <command>

This is the easiest way to stay current — npx always pulls the latest published version. No global install, no version drift across machines.

Or install globally

npm install -g clawnify
# or
pnpm add -g clawnify

Verify

clawnify --version

If the version prints, you’re done. If you get command not found, check that your global bin directory is on your PATH:

npm config get prefix
# → /usr/local, so /usr/local/bin should be on PATH

Login

clawnify login

Authentication uses Supabase OAuth 2.1 with PKCE. When you run login, the CLI:

1. Opens your browser to https://app.clawnify.com/oauth/consent
2. You log in and approve the CLI’s access request
3. The browser redirects to a local server the CLI has spun up on localhost:19823
4. Tokens get saved to ~/.clawnify/auth.json
5. If you’re a member of multiple organizations, the CLI prompts you to pick one

Token refresh is automatic — the CLI refreshes expired access tokens via the OAuth token endpoint before every API call, so you don’t need to re-login until your refresh token is revoked.

The auth file

// ~/.clawnify/auth.json
{
  "access_token": "...",
  "refresh_token": "...",
  "expires_at": 1234567890,
  "org_id": "..."
}

Delete this file to fully log out. The CLI will prompt you to run login again on the next command.

Whoami

Confirm which account and org you’re logged into:

clawnify whoami