App Settings

App-level settings control Trinity's global behavior — preferences that apply across all projects.

Accessing Settings

Click Settings in the sidebar. App settings are on the global settings tab (as opposed to project-specific settings).

Theme

Trinity ships with five themes plus a system-follow option:

Light — clean light appearance with neutral tones
Dark — dark background with light text and cool blue accents
Trinity Dark — dark theme with pure green (hue 145) accents and monospace font throughout — a neon-green Matrix aesthetic
Trinity Light — light theme with green accents and monospace font — the light counterpart to Trinity Dark
Cyber Dark — cyberpunk-inspired dark theme with purple and magenta accents and custom cyber fonts
Cyber Light — bright cyberpunk theme with blue and purple accents
System — follows your operating system light/dark preference (maps to Light or Dark)

Timezone

Your timezone affects:

Recap date groupings (daily, weekly, etc.)
Metrics dashboard time axes
Timestamp displays throughout the UI

The database stores everything in UTC — timezone conversion happens at display time.

Your global settings (theme, timezone, AI models, automation toggles, git configuration) automatically sync across all your devices via Turso. Changes made on one machine appear on others within seconds. Device-specific settings (like local paths) stay local.

Automation Defaults

Default settings that apply to all projects. The full settings hierarchy is: Global → Team → Project → Entity → Job. Team settings (if you're in a team scope) override globals, project settings override both, and per-entity overrides (on individual stories or releases) override project defaults. See Teams for team settings details and Stories for per-entity overrides.

Skip Asset Check

When enabled globally, the "missing assets" execution gate is bypassed for all projects. Useful if you primarily work on projects that don't use uploaded assets.

Skip Business Details Check

When enabled globally, the "missing business details" execution gate is bypassed. Useful for personal/hobby projects where business branding isn't relevant.

Auto-Approve Quality Checkpoints

When enabled, quality checkpoints run their full audit pipeline (analyze, audit/fix loop, documentation) but automatically approve the gate instead of pausing for human review. The gate record is still created for audit trail purposes. Release checkpoints always require manual approval regardless of this setting. Can be overridden per-project.

Help Assistant

A floating help chat is available on every page (bottom-right corner). It answers questions about how to use Trinity using the built-in user guide as its knowledge source.

Toggle it on/off in app settings
Supports image uploads — paste or attach screenshots to ask about specific UI elements
Only answers from documentation — won't execute commands or modify your project
Maintains conversation history within a session

Auto-Update

Trinity checks for updates automatically every 4 hours.

When an update is available, a pill appears in the title bar with an Update Trinity button
Enable Auto-Update in app settings to automatically install updates when Trinity is idle (no stories running)
Trinity never interrupts active execution — if stories are running, it waits until they complete
You can also click Update Trinity manually at any time; if execution is active, you'll see a warning