Getting Started & User Manual

Click "Sign in with email"

Click the primary Sign in with email button. Trinity will automatically launch your computer's default web browser to open the secure Azure verification page.

Enter Your Email Address

In your browser window, type your work or personal email address. A 6-digit One-Time Passcode (OTP) will be sent straight to your inbox.

Enter the 6-Digit Passcode

Check your email inbox, copy the 6-digit verification code, and paste it into the browser window. Once verified, you can close the browser tab and return to Trinity.

Enter Your 4-8 Digit PIN

Type any 4 to 8 digit number of your choice (e.g. 2468 or 123456) in the setup screen.

Confirm Your PIN

Re-enter your chosen 4–8 digit PIN to ensure there are no typos. Once confirmed, your desktop workspace is fully encrypted and ready for use!

Select Your Personal Profile

The login screen displays your avatar and name (e.g. "Welcome back, Adam").

Type Your 4-8 Digit Security PIN

Enter your 4–8 digit PIN to unlock your workspace. Press Enter or click the arrow button to enter Trinity.

Click "Forgot PIN?"

On the daily sign-in screen, click the Forgot PIN? link located below the input field.

Re-Verify via Email

Trinity opens your browser to send a fresh Azure One-Time Passcode to your email inbox.

Create a New PIN

Once re-verified, enter and confirm your new 4–8 digit Security PIN to regain instant access to your app.

Real-Time Visual Ring Indicator

The circular meter updates automatically after every AI prompt, code edit, or web search. The ring reflects your remaining monthly usage balance for paid accounts or free tier request caps.

Tooltip Status

Hover your mouse over the ring to view quick status indicators without opening any menus.

Status Color Indicators

🟢 Green Icon: Database is connected and operating cleanly.
🟡 Yellow Pulsing Icon: Database is running diagnostic checks or automatic health repairs.
🔴 Red Icon: Local database disconnection or error detected.

One-Click Automated Database Repair

If the database icon turns red, simply click the database button. Trinity will automatically diagnose local index files, repair corrupted tables, and restore database connectivity cleanly.

AI Model Selection Submenu

• Chat Models: Choose your primary conversational AI model for chat.
• Photon Models: Select default models for image generation, editing, and inpainting.
• Cypher Models: Configure default models for multi-file coding, architectural planning, and senior auditor code reviews.

Chat History & Storage Cleanup

• Clear All History: Permanently delete all chat history across all modes.
• Delete Old History: Automatically prune conversations older than 6 months.
• Delete Web Search History: Clear past web search transcripts and video summaries.
• Delete All Attachments: Remove cached PDFs, images, and upload files to free up local disk space.

Memora Memory Settings

Configure long-term session memory retention, manage concept relationship maps, and adjust attachment indexing settings.

Account & Registered Devices

• Subscription & Quota Status: Check your active plan, renewal date, and remaining request quota.
• Device Management: View all registered Windows PCs authorized on your account and revoke inactive device sessions.
• Delete Account & Data Wipe: Permanently delete your cloud profile and wipe all local desktop data with confirmation safeguards.

Location Preference Settings

Set your default city and geographic preferences so Websearch provides accurate local recommendations, nearby operating hours, and local deals.

Payment & Pro Options

Upgrade your workspace account to Pro, top up your balance, or view billing details.

Top-Center Hover Trigger

Move your mouse cursor to the small dark tab at the top-center edge of the Trinity application window. Hovering over this tab smoothly reveals the floating window control buttons.

Minimize, Maximize & Close

• Minimize (−): Minimizes Trinity to your Windows taskbar.
• Maximize / Restore (□): Toggles between full-screen and restored window layout.
• Close (✕): Safely closes the desktop application window.

Automatic 3-Second Fade-Out

To keep your workspace 100% distraction-free, the window controls automatically fade out and hide after 3 seconds of mouse inactivity.

Manual Logout Button

Click the Power Icon button on the right side of the System Controls bar to lock your app workspace instantly.

Automatic 3-Minute Inactivity Auto-Lock

If Trinity detects zero mouse or keyboard activity for 3 minutes, the desktop application automatically logs out and locks your workspace. Simply enter your 4–8 digit Security PIN to resume right where you left off!

Click the Sidebar Toggle Button

Click the Panel Left icon (Ctrl+B) located at the top-left edge of the workspace to slide open your Chat History drawer.

Smooth Backstage Mount

The Chat History panel stays pre-mounted in memory, ensuring zero visual jank or rendering lag when opening or collapsing the sidebar.

Click the New Chat (+) Button

At the top-right of the Chat History header, click the + Plus Icon button to open a clean chat canvas.

Automatic Top-Pinning & Smooth Scroll

When you send your first message in a new session, Trinity automatically generates a concise conversation title and places the new chat at the top of your list.

Type in Search Input

Type any keyword, phrase, or project name into the Search conversations... input bar at the top of the history drawer.

Live Title & Preview Filter

The virtualized list filters sessions in real time by checking titles and message previews. If no matches are found, an animated No Matches empty state is displayed.

Click the Bookmark Icon

Hover over any chat session card and click the Bookmark Icon (🔖) on the right side.

Pinned Block Priority

Bookmarked sessions automatically move into a dedicated pinned block at the very top of your Chat History list so they are never lost under newer conversations.

Open Options Menu (⋮)

Click the Three Vertical Dots (⋮) menu trigger on any session card in the list.

Select "Add Context"

Click Add Context. The session title turns Emerald Green, indicating that Trinity's AI will automatically incorporate that chat's knowledge into your active prompt thread.

Delete Individual Chats

Open the ⋮ Options Menu on any session card and select Delete Chat (red trash icon) to permanently wipe that conversation thread and cached attachments.

Virtualized Infinite Scroll & Bulk Clearance

Trinity uses high-performance list rendering to display thousands of chats seamlessly. For bulk cleanup, use the Clear All History or Prune >6 Months tools in the System Settings menu.

Where & How to Open

The Dynamic Sidebar is located on the right side of your workspace. It slides open automatically whenever you select a project, open a PDF document, or generate AI images. You can also click any of the top tab triggers to toggle between canvases.

3-in-1 Canvas Header Bar

Use the top tab switcher to toggle seamlessly between your active tools:

• Code Canvas: Code editor and full repository analysis.
• File Canvas: PDF document reader and citation highlighter.
• Image Canvas: Photon AI Visual Studio and reference image slots.

Lazy Loading Performance

Each canvas tab is lazy-loaded on demand with smooth background skeletons, ensuring lightning-fast sidebar animation without consuming system memory when inactive.

Selecting & Authorizing a Project

At the top of Code Canvas, open the Project Selector Dropdown and select your local codebase folder. Trinity performs automatic project analysis to map functions, imports, and cross-file dependencies across your entire codebase.

Browsing the File Tree Sidebar

Use the left collapsible File Tree to inspect project files (.tsx, .ts, .py, .json, .rs, .go). Clicking any file opens it instantly inside the code editor with line numbers and syntax highlighting.

Security & Invisible Unicode Shield

Code Canvas automatically scans code files for dangerous invisible Unicode characters, bidirectional overrides (BIDI), and homoglyph attack vectors to protect your repository from hidden malicious code injection.

AI Refactoring & Direct Disk Save

Review AI-generated code edits side by side. Click Copy Code or Save to Disk to apply refactored changes straight into your project repository.

Opening Documents & Citation Links

Click any document citation link in an AI response or select a PDF from your Librarian storage to open it inside the interactive document viewer canvas.

Automatic Citation Jump & Highlight

When you click an answer citation, File Canvas automatically scrolls to the exact page number and highlights the referenced text passage in yellow for 100% verification accuracy.

Page Toolbar & Search Controls

Use the top toolbar to jump between pages, zoom in/out, fit to width, search for keywords inside the PDF, or download a local copy of the file.

Managing Reference Slots (Image 1, 2, 3)

Image Canvas features 3 reference slots (Image 1, Image 2, Image 3). Drag & drop images into slots or click Upload to provide visual reference assets for AI image creation.

Interactive Image Editor Tools

Click the Edit Pencil Icon on any image card to open the built-in Image Editor (ImageEditor.tsx). Adjust color grading (brightness, contrast, warmth, saturation, vignette), apply 90° rotations and flips, or crop image boundaries.

Text Overlays & Image Stamping

Add custom text layers with font choices, colors, and styling (bold, italic, underline). Upload secondary image overlays, resize/rotate stamp layers, or draw with the mask brush and eraser tools.

Full-Screen Lightbox & High-Res Export

Click any image thumbnail to expand it in full-screen Lightbox mode or click Download to save PNG renders directly to your computer.

Auto-Resizing Prompt Input

Type your message into the prompt bar. The input field expands smoothly as you type. Press Enter to send or Shift+Enter for multiline line breaks.

File Attachment Uploads

Click the File Attachment option in the + Tools Menu to attach local documents, source code files, or images directly into your prompt thread.

Deep Codebase Analysis

Cypher reads and maps your local project folder to understand function definitions, class structures, imports, and cross-file dependencies.

Direct Disk Modifications

Generates multi-file code updates and allows you to apply refactored changes straight to your local project disk.

Brain Icon Project Manager & Workspace Selector

Click the active Brain Icon on the prompt bar to launch the Project & Workspace Manager. Select, switch, and authorize local codebase folders or scope specific subdirectories for Cypher's AI architect.

Desktop File Search

Search, locate, and manage local documents, code files, and installed software packages directly from your workspace.

Brain Icon Directory Scope Selector

Click the active Brain Icon to open the Directory Scope Selector. Restrict desktop file searches to specific local drives or folders and organize software packages cleanly.

Cross-Session Memory

Remembers key project preferences and user instructions across chat sessions. You can search, update, or wipe stored memories anytime for total privacy control.

Brain Icon Memory Context Vault Manager

Click the active Brain Icon to open the Memory Context Vault. Search through stored user preferences, toggle active memory context, or erase outdated entries.

Interactive Document Citations

Answers questions grounded strictly in your uploaded PDFs, complete with clickable page citations that scroll directly to highlighted source passages.

Brain Icon Document Vault & Quiz Selector Panel

Click the active Brain Icon to open the Document Vault Selector. Select PDF files or document groups, set page extraction ranges, compare document summaries, or generate interactive study quizzes.

Reference Slots & Image Editing

Supply up to 3 reference images, set resolution outputs, view in full-screen Lightbox mode, or launch the built-in Image Editor.

Brain Icon Visual Reference Panel

Click the active Brain Icon to open the Visual Reference Panel. Manage reference image slots (Image 1, 2, 3), set per-slot text prompt guidance, and select target output resolutions.

Real-Time Web Results

Connects Trinity to live internet search results for real-time news, documentation updates, and online research, complete with clickable source links.

Brain Icon Web Research Selector

Click the active Brain Icon to open the Web Research Selector. Pick target web sources (Wikipedia, arXiv, GitHub), set search depth, and select research output formats (Summary, Compare & Contrast, Key Insights, Detailed Deep-Dive).

Syntax Highlighting & One-Click Copy

All AI-generated code blocks feature syntax highlighting across languages (TypeScript, Python, Rust, Go, SQL, HTML/CSS). Click the Copy Code button at the top right of any code box to copy code snippets straight to your clipboard.

Open Code in Code Canvas

Click Open in Code Canvas on any code block header to load the code directly into the interactive right-hand Code Canvas editor for refactoring or disk saving.

Clickable Citation Badges

AI answers generated in Librarian mode include inline page tags (e.g. [Page 14]). Click any citation badge to open the PDF inside File Canvas and scroll automatically to the highlighted source passage.

Source Text Tooltips & Relevance Scores

Hover over citation tags to view a tooltip card displaying the exact quoted sentence from the document, source document name, and relevance match score.

Organic Search & Favicon Cards

Websearch mode formats online search results into clickable cards showing website titles, live site favicons, full URLs, and summary snippets.

Stock Finance & News Media Cards

Queries about financial markets render live stock price cards (current price, day change, exchange ticker), while news queries display headline article cards with publishing timestamps.

Copy Full Message

Click the Copy icon on the response toolbar to copy the entire response text to your clipboard.

Export Response as PDF

Click the Export PDF icon to save the formatted AI response as a clean, printable PDF document on your computer.

Rewind & Regenerate Response

Click Rewind / Regenerate to erase the current response turn and regenerate a fresh answer from the latest context state.

Bookmark Key Messages

Click the Bookmark icon to save important AI responses to your Bookmarked Messages tab for fast retrieval.

Active Mode Status Indicators

The status footer at the bottom of the prompt area displays real-time badges confirming active modes (e.g. Cypher is active, Librarian mode active, WebSearch is active, Photon is active) and reports total file attachments or retrieved memories.

Where It Is Used

Activates automatically during Cypher Mode when analyzing complex multi-file engineering tasks or designing project refactoring steps.

Capabilities & Functionality

Inspects your codebase folder to map function relationships and cross-file dependencies. It generates structured step-by-step implementation plans so complex changes are mapped cleanly before any code is modified.

Where It Is Used

Activates inside Code Canvas, AI code generation, and Cypher code refactoring execution.

Capabilities & Functionality

Performs exact line-by-line code edits and bug fixes without overwriting unrelated project files. Performs instant syntax and quality checks after edits to ensure code compiles cleanly before saving directly to your local project disk.

Where It Is Used

Activates when creating brand new software projects, setting up framework templates, or initializing development environments.

Capabilities & Functionality

Initializes fresh project directory structures for your chosen stack (React, Python, Rust, Go, Flutter, Django, etc.), installs required library packages, and scaffolds clean starter files ready for immediate development.

Opening MCP Server Settings

Navigate to Settings > Utilities > MCP Servers to view, manage, and configure custom tool servers.

Adding a Pure Python MCP Server

Click Add Server Snippet and select Python as the runtime. You can set up your server in two simple ways:

import sys
# 1. Add your local MCP server source directory
sys.path.insert(0, r"C:\path\to\your\mcp_server\src")

# 2. Import the main entry point function
from my_mcp_server import main

if __name__ == "__main__":
    main()

Automated Verification & Activation

Trinity performs an automatic security scan and provisions required dependencies. Once approved, custom MCP tools become active in Default Chat automatically.

Selecting Working Mode Tabs

Open Settings > Utilities > Skills & Hooks and select the target mode tab you want to customize (Librarian, Memora, Catalog, Cypher, WebSearch).

Writing Custom Rules (Up to 12,000 Chars)

Write your custom behavior guidelines in Markdown format. Custom rules take priority over standard mode instructions, giving you exact control over response style and formatting.

Execution Checkpoint System (Start, Main, End)

Organize custom rules into strategic execution sequence checkpoints within your mode workflow:

• Start Checkpoint: Acts like an external context provider, injecting initial context, data feeds, and prerequisite background info before primary mode prompts run.
• Active Main Skill: Main operational behavior guidelines for general query handling and core agent execution.
• End Checkpoint: Defines what the system needs to execute after the task is done, running provided concluding scripts, mandatory output formatting, and post-task validation procedures.

Adding Profile Cards

Open Settings > Utilities > Relationships and click Add Contact. Enter name, full name, nickname, relationship type, email, phone number, location, and address.

Master Profile & Context Recall

Check Is Master Profile to mark your primary profile. Memora and AI assistant modes query local relationship records to recall personal details accurately during conversation.

Built-in Background Themes

Open Settings > Utilities > Chat Backgrounds and select built-in themes like Solid Black (shipped default) or Default AI Chat.

Uploading Custom Wallpapers & Resolution Presets

Upload up to 6 custom images (up to 8 MB each). Choose resolution presets (1080p, 2K, or 4K) for automatic client-side optimization.