TransIT AI
Sign up

How-tos

Sign in

This page covers how to sign in to Transit AI Cloud the first time. Sign-in is required for the AI agent; the SSH client works offline.

Steps

  1. Open Transit AI. The sidebar footer shows a Sign in chip.
  2. Click Sign in. Transit AI launches your system browser at the sign-in page.
  3. Complete the auth flow in the browser (email, password, passkey — whatever you’ve set up).
  4. The browser shows a “You’re signed in” confirmation and automatically hands control back to Transit AI via a transit:// deep link.
  5. The desktop’s sidebar footer now shows your account chip with your tier (Free / Pro / Max).

What’s stored on disk

After sign-in, two short-lived items live in your OS keychain:

  • An access token (15 minutes, refreshed automatically)
  • A rotating refresh token (30 days, replaced on every refresh)

No prompts, no completion content, no device data is stored or synced to the cloud as part of sign-in.

If the browser doesn’t come back to Transit AI

The deep-link handler is registered with your OS on first install. On macOS, if you’ve never run a signed Transit AI build, Launch Services may not have indexed the handler. Workarounds:

  • macOS: open Transit AI at least once before sign-in.
  • Linux: ensure your desktop environment has registered transit-app.desktop.
  • Windows: re-run the installer if the deep-link handler is missing.

If you’re still stuck, sign in from the browser and copy the URL it tries to open; paste it into the address bar of a fresh browser window to trigger the handler manually.

Signing out

Settings → Account → Sign out. Revokes the refresh token server-side and clears keychain entries. The next start prompts for sign-in again.