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 CLAUDEASSISTSERVER).

Connecting an account (OAuth flow)

1. Create the account — returns an authUrl:

``bash scripts/google-axi account create --identifier owner --email [email protected] ``

1. Authorize: give the authUrl to 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.

1. Verify: scripts/google-axi accounts — the account should show authed: 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

<!-- BEGIN GENERATED: command-reference -->

Accounts

• scripts/google-axi accounts — list all Google accounts with credential + sync/triage status
• scripts/google-axi account get <id> — full account detail including settings
• scripts/google-axi account create --identifier ID --email EMAIL [--name NAME] — create an account and return an OAuth authUrl for the user to authorize
• scripts/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 settings
• scripts/google-axi account reauth <id> — mint a fresh OAuth authUrl for an existing account
• scripts/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 disambiguation
• scripts/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

<!-- END GENERATED: command-reference -->

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-gmail skill (gmail-axi) to sync,

search, and triage its mail.