Install & log in

The @getresolved/cli package gives you the full GetResolved toolkit on the command line — manage issues, conversations, products, releases, and members from your terminal, and wire up the /get-resolved slash command for Claude Code in one step.

Install

npm install -g @getresolved/cli

This puts a getresolved binary on your PATH. For one-off use without installing, prefix any command with npx @getresolved/cli@latest.

Requires Node.js 18 or later.

Log in

getresolved login

Opens a browser-based device-code flow and writes your API key to ~/.getresolved/auth.json (chmod 0600). Every subsequent call reads from there — you only do this once per machine.

Flags

• --api-key=<key> — skip the browser flow and persist the provided key. Used by CI.
• --api-url=<url> — point at a non-default API (e.g. local dev).
• --force — re-authenticate even if a session already exists.

getresolved whoami    # show the active workspace + member
getresolved logout    # remove the global auth file

Auth lives globally — projects only store a product link

The CLI keeps your API key and API URL in ~/.getresolved/auth.json. When you run `getresolved init` inside a project, it writes a small .getresolved/config.json containing the product_id link — no API keys are ever written into your project directory, so it's safe to commit.

Resolution order for any value: command-line flag → environment variable → project .getresolved/config.json → global ~/.getresolved/auth.json → built-in default.

Global flags

Accepted on every resource command:

• --json — emit JSON to stdout instead of the human-readable table. Suppresses the daily update-check notice — use this in pipelines.
• --product=<id> — override the linked product for this call (also --product-id=<id>).
• --api-key=<key> — override the stored API key.
• --api-url=<url> — override the API base URL.
• --local — shortcut for --api-url=http://localhost:3600.

Environment variables

• GR_API_KEY — override the API key globally
• GR_API_URL — override the API base URL globally
• GR_PRODUCT_ID — override the linked product globally
• GETRESOLVED_API_URL — legacy alias for GR_API_URL

Per-call flags always win over env vars, which always win over the global auth file.

Slack

Optional — connect Slack to your workspace from the CLI (same OAuth flow as the dashboard):

getresolved setup-slack