assist-google-setup
Set up and manage Google accounts (OAuth) via the bundled google-axi CLI — a script
in this skill's scripts/ directory (not on PATH). This is the shared Google account
foundation that assist-gmail (and future Google-service skills) build on. Invoke it
by its path relative to this skill's base directory:
scripts/google-axi # home: accounts + auth status
scripts/google-axi --help # full command list
scripts/google-axi <command> --help # usage for any command
Output is TOON; pass --json for raw API JSON. The server
defaults to http://localhost:2529 (override with CLAUDE_ASSIST_SERVER).
Connecting an account (OAuth flow)
Create the account — returns an
authUrl:scripts/google-axi account create --identifier owner --email owner@example.comAuthorize: give the
authUrlto the user to open in a browser and grant access. The OAuth callback completes authorization server-side; the account then has credentials and can sync.Verify:
scripts/google-axi accounts— the account should showauthed: yes.
identifier is a short stable handle (e.g. owner) used everywhere else (e.g.
gmail-axi emails --account owner). Use account reauth <id> to mint a fresh authUrl
if tokens are revoked or expired.
Name aliases
Aliases disambiguate who email is from/to and who commitments refer to. By default a new
alias refers to the account owner; for someone else, pass --not-owner --refers-to "<name>".
Commands
Accounts
scripts/google-axi accounts— list all Google accounts with credential + sync/triage statusscripts/google-axi account get <id>— full account detail including settingsscripts/google-axi account create --identifier ID --email EMAIL [--name NAME]— create an account and return an OAuth authUrl for the user to authorizescripts/google-axi account update <id> [--name TEXT] [--primary] [--triage-instructions TEXT] [--label-prefix TEXT] [--label-prefix-todo TEXT] [--sync-start-date DATE]— update display name / primary flag / triage + label settingsscripts/google-axi account reauth <id>— mint a fresh OAuth authUrl for an existing accountscripts/google-axi account delete <id>— revoke tokens and delete the account (cascades to its emails/aliases)
Aliases
scripts/google-axi aliases <account-id>— list name aliases used for commitment/sender disambiguationscripts/google-axi aliases add <account-id> --alias NAME [--not-owner] [--refers-to NAME] [--notes TEXT]— add a name alias (default marks it as referring to the account owner)scripts/google-axi aliases remove <account-id> <alias-id>— delete a name alias
Notes
- Settings like triage instructions and Gmail label prefixes are edited with
account update <id>(e.g.--triage-instructions,--label-prefix). - Deleting an account revokes its OAuth tokens and cascades to its emails and aliases.
- Once an account is authorized, use the
assist-gmailskill (gmail-axi) to sync, search, and triage its mail.