Authentication
rscontacts uses OAuth2 to access the Google People API on your behalf.
How It Works
- You provide OAuth2 client credentials (a JSON file from Google Cloud Console)
- On first use, rscontacts opens your browser to get consent
- The access token is cached locally for future requests
Files
| File | Location | Purpose |
|---|---|---|
| Credentials | ~/.config/rscontacts/credentials.json | OAuth2 client ID and secret |
| Token cache | ~/.config/rscontacts/token_cache.json | Cached access/refresh tokens |
Commands
Authenticate (opens browser):
rscontacts auth
Authenticate without browser (prints URL):
rscontacts auth --no-browser
Force re-authentication (removes cached token first):
rscontacts auth --force
Scopes
rscontacts requests the https://www.googleapis.com/auth/contacts scope, which provides full read/write access to your Google Contacts.