grithdocs

grith pro

pro

Sign in, activate and refresh a licence, pull team policy, and manage billing from the terminal.

Pro
grith pro login [--api-key <KEY>]
grith pro status | activate | refresh | logout | sync | upgrade | start-trial | billing

Everything to do with your grith.ai account and licence. login is the only subcommand with a flag; omit --api-key and it uses browser device authorisation instead.

Subcommands

SubcommandWhat it does
loginAuthenticate with grith.ai. Device auth by default, API key optional.
statusPlan, licence expiry and team.
activateFetch and activate a fresh licence.
refreshForce an on-demand licence refresh.
logoutRemove the stored credentials and licence.
syncPull team policy, configs and provider keys.
upgradeOpen the pricing page in a browser.
start-trialStart a free Pro trial, or open signup.
billingShow the plan and open the billing portal.

Signed out

status reports the state and exits 0. Everything that needs a licence exits 1 with the same one-line instruction, so a script can tell the two apart.

terminal
$ grith pro status
Not logged in.
Run: grith pro login
     or: grith pro login --api-key <key>

$ grith pro sync
Error: Not logged in. Run: grith pro login

activate, refresh, billing and sync all behave that way. logout always succeeds: Logged out. Pro features disabled.

sync pulls, it does not upload

ℹ️Sync moves team state, not your audit log

The raw audit-record upload was retired. grith pro sync pulls team policies, team configuration and provider keys, and pushes reputation data. It uploads no audit records, and nothing on the team dashboard is a copy of your audit log.

Aggregated metrics are a separate, consented, opt-out-able path - grith analytics.

What Pro includes

Cloud sync, usage analytics and the policy editor, plus a session ceiling of 64 rather than 2. See What is in Pro.

See also

Last updated: 2026-08-24Edit this page on GitHub →