assist-google-setup

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)

1. Create the account — returns an authUrl:

scripts/google-axi account create --identifier owner --email owner@example.com

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.
2. 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

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

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.