Documentation Hub
Search⌘K

Suggest Article

Suggest Edit

Articles

Articles

173 articles in the index

How Optix AI Works - System Overview

The top-level runtime split between API routing, prompt assembly, persistent state, browser and desktop extensions, and outward-facing product shells.

The AI Brain - How Optix Generates Responses

How Optix selects providers, builds prompt layers, injects memory and research, and chooses between direct answers and tool-heavy flows.

Models and Capabilities - Specifications

The model catalog, routing aliases, and capability mapping across Groq, Google, Mistral, OpenRouter, and compatible providers.

Database Architecture - Supabase Schema

The feature-led schema behind conversations, memory, projects, generated files, browser automation, desktop control, and public sharing.

Authentication and Sessions

How request identity, JWT-aware Supabase clients, and session-linked API behavior currently fit together across the runtime.

Deployment and Infrastructure

How Optix is deployed through Vercel routes, local services, background workers, and environment-driven provider configuration.

Runtime Health, Approvals, and Safety Rails

How Optix reports runtime health, stores approval requests, and blocks dangerous actions behind explicit operator review.

Project Brain Architecture

How Optix stores per-project summaries, chunked context, and repository-aware memory in dedicated project-brain tables and helpers.

API Surface Catalog

A map of the main API routes that expose chat, projects, files, browser sessions, desktop sessions, live share, and support workflows.

Runtime Configuration Matrix

How environment variables, runtime defaults, provider toggles, and legacy compatibility values shape the live Optix behavior.

Background Workers and Job Queue

How asynchronous runs, agent-style work, and queued execution are managed across the queue implementation and worker runtime.

Observability and Log Flows

How Optix records login events, runtime health, approvals, QA notes, and diagnostic signals that help operators understand live behavior.

The Chat Interface - Full Breakdown

The layout, state handling, controls, and message lifecycle of the Optix chat surface across the current web implementations.

Message Streaming and Live Updates

How Optix handles live answer delivery, stream flags, and UI timing across runtime and surface layers.

System Prompts and Workspace Configuration

How workspace settings, custom instructions, personas, and skill-aware prompt sections reshape Optix behavior per request.

Conversation Management

How sessions are created, listed, renamed, deleted, reopened, and attached to projects or share links.

Markdown and Rich Text Rendering

How Optix treats prose, markdown-like output, widgets, graphs, and mixed rich content in chat responses.

Code Execution and Artifacts

How Optix stores generated outputs, associates them with messages, and exposes artifact-style file workflows.

File Uploads and Document Handling

How uploads, OCR, and document helpers extract context and feed it into both chat and file-generation flows.

Memory System - How Optix Remembers

How memory candidates are extracted, persisted, injected into prompts, and revised over time.

Voice Input and Voice Output

How Optix exposes voice UI, voice settings, and speech-oriented preferences in the current web surfaces.

Command Palette and Quick Actions

How Optix exposes fast actions, chips, and operational shortcuts across chat and agent-facing tasks.

Conversation Share Links

How Optix creates tokenized read-only share links, resolves public reads, and revokes shared access.

Graph Answers and Structured Visuals

How Optix detects diagram-worthy prompts and steers output toward structured graph and visual responses.

Trust Signals and Ratings

How trust summaries and rating-derived context appear inside workspace-aware prompt composition.

Search Inside History and Retention

How conversation search, retention fields, and history migrations extend the basic chat schema.

Message Edits, Branches, and Snapshots

How Optix supports editing, branching, and snapshotting conversation history through nested conversation routes.

Chat Titles, Summaries, and Naming Logic

How Optix derives titles, summary hints, and list-friendly names from raw user prompts and conversation state.

Prompt Chips and Suggested Actions

How starter prompts, suggestion chips, and shortcut actions orient the user into the larger Optix feature set.

Workspace Search, Modes, and Context Switching

How workspace settings, project context, and mode-level behavior let one interface behave like multiple specialized assistants.

Web Search Tool

How Optix constructs live web-search queries, feeds result bundles into runtime context, and uses them during response generation.

Imagine Tab and Image Generation

How image generation falls through provider order, checks capability availability, and records image-generation behavior.

Skills System

How markdown-defined and registry-backed skills are loaded, resolved, and injected before the model writes a reply.

Plugins Registry and Permissions

How Optix tracks plugin definitions, permission scopes, and runtime access to explicit plugin capabilities.

Browser Control Agent

How browser sessions, planner snapshots, observations, and agent loops are routed from chat into persistent browser state.

Browser Transport and Realtime State

How browser control links the runtime, websocket manager, and Supabase-backed session state into a live automation surface.

Local PC Desktop Agent

How the desktop agent exposes local machine presence, sessions, commands, and events back into Optix.

Subagents and Multi-Step Reasoning

How Optix spawns background agent threads, tracks runs, and merges multi-step execution back into the parent request.

Temp Mail Workflows

How temporary inboxes are provisioned, checked, parsed for OTPs, and surfaced back into the operating runtime.

System Control Runtime

How Optix inspects processes, opens targets, and routes guarded system commands through the runtime control layer.

Approval Requests and Dangerous Commands

How Optix detects dangerous actions, normalizes approval state, and logs explicit review before risky execution.

Repo and Project Management APIs

How Optix exposes repository and project-level APIs for workspace scans, project metadata, and long-lived context.

Project-Aware Coding Flows

How project context, file manifests, and job-driven execution make Optix more than a generic chatbot for engineering tasks.

Live Data Adapters - Weather, Finance, and Crypto

How Optix short-circuits some requests into live data adapters before falling back to standard model generation.

Browser Human Actions and Form Filling

How Optix issues human-action style commands for browser pages, forms, and interaction repair when autonomous planning is too blunt.

Browser Task Scheduling and Session Tasks

How browser sessions can hold named tasks, start or stop task loops, and keep operator intent attached to a live session.

Browser Temp Mail Integration

How browser sessions coordinate with temporary inbox creation and polling when flows need OTPs or disposable addresses.

Desktop Live Share and Session Streams

How desktop sessions expose live-state sharing routes that mirror browser live-share behavior for machine-assisted assistance.

Calculator AI and Structured Utility Tools

How Optix blends general-purpose models with smaller structured utility tools like calculator history, rates, and AI-assisted math flows.

OCR and Image Understanding Services

How Optix uses OCR-focused endpoints and service helpers when a request depends on text extracted from images or documents.

Location Lookup and Maps Inputs

How Optix resolves place data and geographic context when features need map-aware inputs or location hints.

AI Support and Escalation Workflows

How support-oriented endpoints complement the main chat route with narrower operational or escalated flows.

Recovered Runtime Paths and Fallback Surfaces

How alternate routes and recovered shells preserve useful behavior when the main runtime is degraded or being refactored.

Automatic Visual Rendering

How Optix detects explanation prompts that are clearer as diagrams, HTML widgets, or graph-ready structured answers.

Chart and Graph Pipeline

How chart-like or graph-like requests get routed into special output shapes instead of plain prose.

File Generation - DOCX, PPTX, XLSX, PDF

How Optix creates downloadable files, stores them, and links them back to the chat flow.

Theme and Design Language

How the Optix surfaces use dark-first tokens, restrained accent color, and mixed legacy plus newer UI layers.

Responsive Shell and Mobile Behavior

How current Optix web surfaces adapt to tablet and mobile screens, and where the repo documents remaining polish gaps.

Collab and Comment Surfaces

How collaboration surfaces, shared sessions, and comment-oriented flows are distributed across the repo and schema.

Artifact Panel and File Preview UX

How generated files, previews, and supporting actions are presented so outputs remain inspectable instead of disappearing into plain chat text.

Code Blocks, Widgets, and Presentation Logic

How Optix differentiates code-heavy answers from widget-heavy answers so the interface can keep technical output legible.

Public Research Surface and Wiki Shell

How the standalone research experience mirrors Optix styling while remaining a separate surface dedicated to explanation, not execution.

User Settings and Personalization

How user-facing preferences, display settings, and defaults flow through settings tables and front-end toggles.

Workspace and Team Management

How workspaces partition prompts, context, settings, and shared access across users and projects.

Security Center and Session Recovery

How security-sensitive data like sessions, approvals, logins, and recovery routes form the operator-facing security layer.

Analytics, Tracking, and Trending Signals

How usage signals, article views, and runtime-side event patterns can be turned into operational insight and content ranking.

Notifications, Digests, and Email Delivery

How Optix can send or prepare outbound communication through email-oriented configuration and service boundaries.

Storage Buckets and Upload Policy

How uploaded assets and generated outputs depend on storage configuration, size rules, and access policy decisions.

API Key Management and Provider Secrets

How provider credentials, service keys, and workspace-specific secrets shape which capabilities are available at runtime.

Data Export, Retention, and Deletion Paths

How records survive, expire, or get removed across conversations, generated files, memory, and shared links.

Optix CLI Overview

How the Optix CLI acts as a separate but connected operating surface for project-aware work outside the browser.

CLI Auth and Project Brain Sync

How the CLI identifies projects, syncs repository context, and connects command-line work back into the project-brain system.

Desktop Agent Download and Setup Flow

How the product exposes desktop-agent downloads and onboarding paths before the agent begins pairing and streaming machine state.

Browser Extension Entrypoints

How extension-aware routes create the public entrypoints and control surfaces for the browser agent.

Public Share Pages and Read-Only Views

How public pages expose conversations or live surfaces without granting full editor access to the underlying workspace.

Collab File Map and Surface Inventory

How the repository documents the spread of collab surfaces, runtime modules, and front-end entrypoints.

Legacy Optix HTML Surface

How the classic HTML shell still represents a large portion of the visible product and why it remains relevant during migration.

Local Server and Developer Runtime

How the repo boots locally, starts services, and gives developers a repeatable runtime for testing multi-surface behavior.

Monster Runtime and Delegate Actions

How the documented monster runtime expands Optix into a more assertive, multi-surface operator with explicit delegate actions.

Godmode Personas and Instruction Layers

How persona registries and instruction overlays allow Optix to operate in different tones, task shapes, and authority levels.

OS Surfaces - Brief, Tasks, Inbox, and Calendar

How Optix is evolving toward an operating-system-like layer that can summarize, route, and coordinate work across multiple surfaces.

Feature Roadmap - Past, Present, Future

How the docs and codebase together reveal what shipped, what is stabilizing now, and what the repo is clearly preparing for next.

Records and Milestones

A historical reading of the codebase through migrations, docs, and new runtime surfaces that mark the product's evolution.

QA Notes and Known Product Gaps

How QA notes document what still needs polish, which matters because Optix often ships runtime depth ahead of interface finish.

Deployment Hardening Timeline

How deployment docs and runtime health endpoints reveal the product's path from rough local setup to hardened hosted behavior.

Research Wiki Buildout Strategy

How the standalone research property can scale into a comprehensive engineering encyclopedia without becoming disconnected from the live product.

Deep Research and Source Synthesis

How Optix is moving from quick tool responses toward slower, source-aware, multi-step research synthesis.

Prompt Builder Internals

A focused study of how prompt sections, memory, workspace settings, and role instructions are assembled before generation.

Provider Client Routing

How Optix abstracts provider differences and routes generation work to the right model backend.

Registry Store Persistence

How skills, plugins, and registry-backed definitions persist through shared storage helpers.

Pool Status and Connection Monitoring

How connection health and runtime pool status are exposed to help diagnose hosted failures.

Route Bootstrap and API Entry

How the repo routes incoming requests through config boot files and the shared API entry layer.

Configuration API and Runtime Defaults

How runtime defaults and configuration are exposed to clients and operators.

Legacy Chat Endpoint and Compatibility

How older chat routes still coexist with newer runtime flows during migration.

Chat Message API Contract

How message creation, retrieval, and conversation-linked API behavior are shaped in the dedicated messages route.

Chat History Utility Layer

How helper utilities normalize chat history reads, writes, and compatibility with evolving history schemas.

Workspace API and Settings Sync

How workspace-level settings are exposed and synchronized into runtime prompt behavior.

Public Chat Shell JavaScript

How the main browser shell implements chat interactions in the public JavaScript layer.

Frontend Chat Styling System

How the chat surface styling is layered across dedicated CSS files for the older web shell.

Browser Live Session Surface

How live browser sessions are exposed through public API routes for direct or embedded control.

Browser Shared Session Surface

How shared browser session views are exposed when a live session needs read-only or collaborative access.

Browser Session API

How browser session records are created, updated, and resolved through the dedicated session API.

Browser Control API

How control commands are expressed when Optix needs to act on an already-running browser session.

Browser Agent Event Ingestion

How browser-originated events are posted back to the backend so the agent can reason on fresh page state.

Browser Shared Helpers

How browser routes reuse shared helpers to keep session logic consistent across multiple browser endpoints.

Desktop Live Session Surface

How desktop sessions expose live machine state to the hosted product while a local agent is running.

Desktop Shared Session Surface

How shared or public desktop session views are shaped for remote monitoring and collaboration.

Desktop Agent Download Flow

How the product provides a direct path for downloading and starting the local desktop agent.

Support Route and Recovery Logic

How support-specific and recovered routes preserve product continuity when a primary path is unstable.

Research Workflow Engine

How chained web research is structured in the runtime before results are synthesized into an answer.

Persona Registry Internals

How persona definitions are organized and selected when Optix adopts different operating modes.

Skill Registry Loading

How skill definitions are discovered and materialized for runtime use.

Plugin Registry Loading

How plugin definitions are discovered and checked before the runtime exposes them as capabilities.

Image Generation Resolver

How Optix resolves which image path or provider to use for a generation request.

Weather Adapter Service

How weather requests can be satisfied through a dedicated service instead of a pure model response.

Crypto Adapter Service

How crypto lookups and related live data are separated into a specialized service path.

OCR Service Layer

How OCR work is separated into a service layer so uploads and extraction paths stay consistent.

Coding Runtime Execution

How the coding runtime turns repository-aware context into execution-oriented assistance.

Theme Runtime and Mode Persistence

How display mode, theme preferences, and shell tokens are handled in the older front-end runtime.

Collaboration Frontend Layer

How the collaboration-oriented front-end layer exposes shared surfaces and session-aware UI.

Feature CSS Surface Map

How feature-level styling is distributed across CSS assets in the older shell.

Public Chat CSS Layout

How the main public chat shell arranges panels, messages, and interaction zones through CSS.

CLI Binary and Command Surface

How the Optix CLI binary exposes a command-line operating surface for project-aware work.

Agent Runtime Entry Point

How the local agent runtime boots and begins exposing a machine-facing control surface.

Deployment Playbook

How the deployment guide documents the path from local development to hosted runtime behavior.

Vercel QA Build Notes

How the QA notes capture build-era issues, responsive gaps, and operational polish work.

Multi-Provider Fallback Router

How the extension automatically fails over across 7+ free AI providers with circuit breaker pattern, rate limit detection, and key rotation.

Stealth Manager - Anti-Detection System

How the extension masks browser fingerprints and simulates human-like behavior to avoid detection during automated browsing.

Vision Service - AI Screenshot Analysis

How the extension captures and analyzes screenshots using AI to understand what is displayed on screen.

Self-Healing Engine - Fuzzy Selector Recovery

How the extension recovers from failed element interactions using fuzzy matching and alternative selectors.

Macro Recorder - Workflow Recording and Playback

How the extension records user interactions as reusable macros and replays them for task automation.

DOM Controller - Advanced Element Interaction

How the extension queries, manipulates, and interacts with web page elements through advanced DOM operations.

Event Simulator - Human-Like Browser Events

How the extension simulates realistic mouse clicks, keyboard inputs, and scroll events to mimic human browsing behavior.

Network Interceptor - Request Monitoring

How the extension monitors and logs network requests and responses during automated browsing sessions.

Session Manager - State Snapshots

How the extension saves and restores browser session state including cookies, storage, and open tabs.

Multi-Tab Orchestrator - Cross-Tab Coordination

How the extension manages and coordinates actions across multiple browser tabs simultaneously.

Memory AI - Intelligent Memory Extraction

How the extension uses AI to extract, store, and retrieve important information from browsing sessions automatically.

Auto Setup - One-Click Provider Configuration

How the extension automatically configures AI providers with free API keys on first launch, requiring zero manual setup.

Permission System - Granular Action Control

How the extension controls which actions are allowed, blocked, or require user approval for security.

Task Queue and Scheduler

How the extension manages asynchronous tasks with priority queuing, scheduling, and execution ordering.

Content Script Bridge - Website Communication

How the extension communicates with web pages through a content script bridge for DOM access and widget injection.

Side Panel Interface - Extension Control Center

How the extension side panel provides task input, execution timeline, memory management, and settings in a compact UI.

Floating Widget - Smart Browser Overlay

How the extension injects a floating glass widget into web pages for quick task execution with shadow DOM isolation.

Guardrails System - Content Safety

How the extension sanitizes content, detects threats, and prevents harmful actions before they reach the browser.

Context Menu Integration

How the extension adds right-click menu options for quick browser automation and task creation.

Analytics Service - Usage Tracking

How the extension tracks usage patterns, performance metrics, and feature adoption for improvement.

Audit Logger - Action History Trail

How the extension logs all user actions and system events for accountability and debugging.

Plugin System - Extension Architecture

How the extension plugin system allows third-party extensions to add new capabilities and tools.

Data Sync Engine - Cross-Device State

How the extension synchronizes settings, memories, and session data across devices through Supabase.

Auth Manager - Login and Session Control

How the extension handles user authentication, session management, and secure token storage.

Website Knowledge Engine - Page Analysis

How the extension analyzes web pages to understand their structure, content, and interactive elements.

Page Analyzer - Content Extraction

How the extension extracts text, links, forms, and metadata from web pages for AI processing.

Component Recognizer - UI Element Detection

How the extension identifies and classifies UI elements like buttons, forms, and navigation for interaction.

Design Extractor - Visual Style Analysis

How the extension analyzes visual styles, colors, and layout patterns from web pages.

Task Planner - Natural Language to Actions

How the extension converts natural language instructions into structured action plans for execution.

Context Compactor - Memory Optimization

How the extension compresses and summarizes conversation context to stay within token limits.

Error Recovery - Graceful Failure Handling

How the extension handles errors, retries failed actions, and provides meaningful feedback to users.

Research Store - Information Persistence

How the extension stores and retrieves research results and browsing insights for future reference.

Smart Tab Manager - Intelligent Tab Control

How the extension manages browser tabs intelligently, opening, closing, and switching based on task context.

Document Builder - Output Generation

How the extension generates formatted documents, reports, and structured outputs from task results.

Navigator Agent - Browser Action Execution

How the navigator agent translates high-level instructions into specific browser actions like clicks, scrolls, and form fills.

Planner Agent - Task Decomposition

How the planner agent breaks complex tasks into sequential steps and coordinates with the navigator.

Action Builder - Tool Orchestration

How the action builder assembles and executes sequences of tools to accomplish complex browser tasks.

Event System - Real-Time Communication

How the extension event system enables real-time communication between background workers, content scripts, and UI.

Message Manager - Conversation History

How the extension manages conversation history, message formatting, and context assembly for AI requests.

Prompt Engineering - System Instructions

How the extension constructs system prompts that guide AI behavior for different task types and contexts.

History Manager - Action Timeline

How the extension maintains a timeline of all actions taken during a task for review and debugging.

Speech to Text - Voice Input Processing

How the extension processes voice input and converts speech to text commands for browser automation.

Pre-Configuration - Provider Defaults

How the extension pre-configures free AI provider defaults for instant setup without API keys.

Gateway Client - Backend Communication

How the extension communicates with the Optix backend gateway for AI requests and task delegation.

Optix Connector - Website Integration

How the extension connects to the Optix website for authentication, chat synchronization, and feature access.

Element Resolver - Intelligent Element Finding

How the extension finds and interacts with web page elements using multiple resolution strategies.

Intelligent Element Finder - Smart Selection

How the extension uses AI to identify the best element for interaction based on context and user intent.