Login Guide

Sign in to AICHE on any platform. Google OAuth, Apple Sign In, GitHub, email magic links, and team credentials.

3 min read
Last updated: 4/7/2026
loginauthorizationsetup

How to sign in to AICHE on every platform.

Desktop (Mac, Windows, Linux)

  1. Click Sign In in the app
  2. Your browser opens to aiche.app for Google authentication
  3. After signing in, the browser redirects back to the app via the aiche:// URL scheme
  4. The app activates automatically

Token storage: Mac uses SecureStorage (AES-GCM encrypted files). Windows uses Windows Credential Manager. Linux uses the same SecureStorage approach.

iPhone / iPad

Choose your sign-in method:

  • Sign in with Apple (primary on iOS)
  • Sign in with Google
  • Sign in with GitHub (opens in-app browser)
  • Sign in with Email (magic link - enter email, tap the link you receive)
  • Team sign-in (email + password for team accounts)

Android

Choose your sign-in method:

  • Continue with Google (one-tap OAuth)
  • Continue with GitHub (opens Chrome Custom Tab)
  • Continue with Email (magic link)
  • Team login (email + password)

Chrome Extension

  1. Click the AICHE extension icon
  2. Click Sign In
  3. A new tab opens to aiche.app/connect-chrome
  4. Authenticate with Google
  5. The extension auto-connects via callback URL

If your session expires (device revoked from another device), the extension shows a "Session Expired" notification. Click it or open the popup to reconnect.

Obsidian Plugin

  1. Settings > AICHE Voice > Sign In
  2. Browser opens aiche.app/connect-obsidian
  3. Authenticate with Google
  4. Plugin connects via obsidian://aiche-auth deep link

Manual fallback: If the deep link doesn't work, copy the code shown on the browser page and paste it into the plugin settings.

Tokens are encrypted with AES-GCM and stored locally. Auto-refreshes on startup if expired or expiring within 1 hour.

Apple Watch

The Watch app inherits your iPhone's login. No separate sign-in needed. If the Watch shows sign-in issues, force-quit both apps and reopen the iPhone app first.

Troubleshooting

Browser doesn't redirect back to app: Check that the aiche:// URL scheme is registered. On Linux, reinstalling the DEB package re-registers it. On Mac/Windows, it's registered on install.

"Sign in" button does nothing: Check your internet connection. The app needs to reach aiche.app for authentication.

Token expired: The app auto-refreshes tokens. If it fails, sign out and sign back in.

Team login vs regular login: Team login (email + password) is only for team/enterprise accounts. Most users should use Google, Apple, or email magic link.

Back to Help Center