Install & Login

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

Install

Scaffold a new app in one command

Fastest path — no install needed:

pnpm create clawnify-app@latest my-app --yes
# or: npm / yarn / bun create clawnify-app@latest my-app --yes

This calls create-clawnify-app, which wraps clawnify init for npm’s standard create-* convention.

Run a single command with npx

npx clawnify <command>

npx always pulls the latest published version. 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

Your browser opens to authorize the CLI (OAuth 2.1 with PKCE) — the sign-in URL is also printed, so you can complete it from any browser on any device. On the same machine, sign-in finishes automatically; from a remote browser (e.g. over SSH), the page shows a code to paste back into the terminal. No port forwarding needed.

You don’t pick an organization at login — the first command that needs one asks once and remembers it. Switch anytime with clawnify org use <slug> or per-command --org.

Token refresh is automatic — you stay logged in until you explicitly log out.

Logout

Delete the credential file:

rm ~/.clawnify/auth.json

The next clawnify command will prompt you to log in again.

Whoami

Confirm which account and org you’re logged into:

clawnify whoami