Signing In

Trinity requires a trinityailabs.com account. When you first launch the app, you'll see the login screen.

Device Code Flow

Trinity uses a device code flow for authentication — similar to how streaming apps sign in on TVs:

  1. Click Sign In in the Trinity desktop app
  2. A device code appears (e.g., BE279D70)
  3. Click Open in Browser to open trinityailabs.com/desktop in your default browser — or click Copy Link to paste the URL in any browser or profile
  4. Log in on the website if needed
  5. The code is automatically confirmed
  6. Trinity detects the approval and signs you in

On a brand-new account, you'll see a Setting up your workspace checklist for about a minute right after authorization while Trinity provisions your personal database. After that you land in the app. Subsequent sign-ins skip this step.

The device code expires after 10 minutes. If it expires, click Cancel and start again.

First-Time Workspace Setup

Every workspace — your personal one and each team — needs two things before Trinity can work in it: a connected git account (Trinity creates repos and opens PRs as you, and teams grant access by account) and a default destination (the host and organization new repositories land in). If either is missing when you enter a workspace, Trinity shows a setup screen in place of the app until it's done.

Set up Git for this scope comes first. You can:

  • Click Use @you if Trinity finds a GitHub account your gh CLI is already signed in to
  • Auto-import from your CLIs — pick from the accounts gh, glab, or tea already hold
  • Connect an account manually with a token, or through a guided CLI sign-in
  • Install & sign into the GitHub CLI if you don't have gh yet — Trinity walks you through it (and shows install instructions for Git itself if it's missing)

Where should new repos go? comes next: pick the host, the owner/organization, who you act as, and HTTPS or SSH. You can change this any time later in your git settings. In a team workspace, only owners and managers can set the team's default — if you're a member of a team that doesn't have one yet, you'll see who to ask and a Check again button; the app unblocks the moment it's set.

After the setup screen clears, you may still see a dismissible banner saying some accounts aren't set up on this device — that happens when an account you connected on another machine needs its credential here too. Click Set up here next to the account to fix it; it doesn't block you from working.

Free Trial

New accounts get a 15-day free trial automatically — no credit card required. Your trial starts the first time you sign in.

While trialing, you have full access to all features. Your settings page shows a countdown with days remaining. When the trial ends, Trinity shows a "Your free trial has ended" screen — subscribe at trinityailabs.com/pricing to keep your work and continue using the app.

Account Types

  • Free trial — 15 days of full access, auto-started on first sign-in
  • Self-paid — subscribe at $10/month for continued access
  • Team seat — a team owner pays for your seat

Both paid types get the same features. One subscription per person.

Signing Out

Click your avatar (initials bubble) in the top-right corner of the sidebar header, then click Sign out.

Session Persistence

Your login persists across app restarts. You won't need to sign in again unless:

  • You explicitly sign out
  • Your session is revoked server-side

Trinity requires an active internet connection to do most things — all project data (PRDs, stories, knowledge, etc.) lives on trinityailabs.com and is reached via the /api/* HTTP layer, so reads and writes both need connectivity. AI providers and git operations (push, PRs, merges) obviously need it too.

Multiple Accounts

Trinity supports signing in with more than one account simultaneously.

Adding an account

  1. Click your avatar in the top-right corner of the sidebar header
  2. Click Add account
  3. A new device code appears — open the link in any browser window (use Copy Link to open it in a different browser profile or incognito window)
  4. Approve the code on the website
  5. The new account appears in the account switcher

Switching accounts

Click your avatar → click any other account listed in the menu. Trinity switches the active session and reconnects to that account's database.

Signing out vs removing an account

Click your avatar → click Sign out at the bottom of the menu to sign out of the active account. The account stays in the picker so you can sign back in without re-entering your email.

To fully remove an inactive account from this device, click the × next to it. The account disappears from the picker and its local cache is wiped.