Getting Started

Installation

LynxAI runs on Windows and installs in under a minute. Download the latest setup file and follow the steps below.

  1. Download LynxAI_Setup.exe from the link on the homepage or from the GitHub releases page.
  2. Run the installer. Windows may show a SmartScreen prompt — click More info → Run anyway.
  3. The installer places Lynx in your Program Files folder and creates a desktop shortcut.
  4. Launch Lynx from the shortcut. A login screen will appear on first run.
  5. Create a free account with your email, or sign in with Google.
Getting Started

First Launch

On first launch, Lynx plays a welcome message and shows a quick onboarding screen. After that, the main chat interface appears and Lynx is ready.

What happens at startup

  • Lynx calibrates your microphone's ambient noise level for 2 seconds — you'll see a "Calibrating…" status. Speak normally after that.
  • Your saved settings and chat history are loaded from the local database.
  • Lynx signs you in automatically using your saved token — you won't need to log in again unless you log out manually.
  • If you have any connected MCP plugins, they are loaded and made available to the AI immediately.
ℹ️

LynxAI requires an active internet connection at all times — the AI runs on cloud infrastructure. Voice, chat, and all features are unavailable without a connection.

Using Lynx

The Interface

The main Lynx window is a full-screen chat UI. On the left you have your chat history. In the center is the conversation area. At the bottom is the input bar.

Chat History

All past conversations are saved and listed in the left panel. Lynx auto-names each chat based on your first message. You can rename or delete any chat by clicking on it.

Input Bar

Type your request and press Enter, or click the microphone button to switch to voice mode. You can stop Lynx mid-response by clicking the stop button that appears while it's working.

Status Indicator

A small status pill shows what Lynx is currently doing — "Thinking…", "Working on it…", "Reading screen…", etc. This updates in real time as tasks run.

Settings & Billing

Access settings from the sidebar. The billing/subscription page is also available from inside the app — you don't need to open a browser.

Memory Page

Accessible from the sidebar. Shows all facts Lynx has permanently saved about you. You can review and delete individual facts from this page. Memory can hold up to 60 facts; you'll be notified when it's full.

Using Lynx

Voice Commands

Lynx has a two-stage voice engine. The first stage listens cheaply in the background for your wake word. Only after hearing it does the second stage activate for high-quality transcription of your actual command.

Waking Lynx

Simply say "Lynx" anywhere in a sentence and the app will activate. You don't need a specific phrase — "Hey Lynx", "Lynx, open…", or just "Lynx?" all work. Lynx replies with "Yes?" when it's listening.

💡

The wake word engine handles common mishearings automatically — words like "Links", "Linux", "Jinx", and others are corrected to trigger correctly.

Voice States

Lynx's voice engine has four states, visible in the app's status indicator:

Idle Listening Thinking Speaking
  • Idle — waiting for the wake word. No microphone data is sent to any server.
  • Listening — Lynx heard its name and is now recording your command. Speak naturally. It stops recording after ~1.4 seconds of silence.
  • Thinking — your audio is being transcribed and the AI is processing your request.
  • Speaking — Lynx is reading the response aloud via TTS.

Interrupting

You can interrupt Lynx at any time — while it's thinking or speaking — by speaking loudly for about 350ms. Lynx will stop and go back to listening immediately. You can also click the stop button in the UI.

Ending a voice session

Say any of the following to put Lynx back to idle:

> "Sleep" | "Stop listening" | "Goodbye" | "Never mind" | "Bye bye"

Voice Models

Lynx uses AI-generated voices for TTS. You can change the voice in Settings. Available voices:

  • Alex — Male, professional (default)
  • Ashley — Female, bright
  • Oliver — Male, friendly
  • Elena — Female, calm
  • Hades — Male, deep
ℹ️

AI Voice (TTS) and wake word detection require a Pro plan or above. The Free and Basic plans support text responses only.

Using Lynx

Desktop Control

Lynx can control your PC like a human would — clicking elements on screen, typing into applications, running commands, browsing the web, and managing files — all from a single natural language request.

How it works

When you give Lynx a task (not just a question), a specialized Executor takes over. It runs a step-by-step action loop: read the screen, decide what to do, act, verify the result, and continue until the task is complete. You see a live status update with each step.

💡

You don't need to install anything special for Lynx to control an app. It works with any software that has a visible UI — including browsers, code editors, Office apps, games, system utilities, and more.

Permissions

Before performing actions that modify your system (writing files, sending emails, submitting forms, etc.), Lynx shows a permission prompt by default. You can approve or deny each action.

You can change this in Settings under Tool Execution:

  • Always Ask (Default) — Lynx prompts before each significant action. Recommended.
  • Always Approve — Lynx acts without asking. Faster, but use with care.

Browser automation

Lynx has a dedicated browser agent that can open websites, read page content, fill out forms, and click through multi-step web flows — all from one command.

⚠️

When Lynx controls the browser, avoid touching the mouse or keyboard until it's done, as this can interfere with the automation.

Using Lynx

Mobile App

The Lynx mobile app is a companion that lets you control your desktop from your phone. Commands sent from the phone run through the same AI pipeline as if you were sitting at your computer.

Setup

  1. Install the Lynx mobile app on your phone.
  2. Sign in with the same account you use on the desktop app.
  3. Make sure the desktop app is running on your PC. The mobile app shows a live PC Online / Offline status indicator at the top.
  4. Type or speak a command. The PC picks it up, executes it, and sends a reply back to your phone.

What you can do from mobile

  • Send text commands to Lynx on your PC, just like you would from the desktop chat.
  • Use the microphone button to speak commands directly on your phone.
  • After Lynx executes a task, a screenshot of your PC screen is automatically captured and sent to the mobile app so you can see what happened.
  • Receive live status updates as Lynx works — you see the same "Thinking…", "Opening app…" status messages on mobile.
  • Approve or deny permission prompts remotely. If the PC app is set to "Always Ask", the prompt appears on your phone and you tap Allow or Deny.

PC Status

The mobile app shows a green dot and "Online" when your desktop is running Lynx. If the PC is off or the app is closed, it shows "Offline". The status is updated every 30 seconds via a cloud heartbeat.

Mobile Settings

From the mobile app's sidebar you can adjust:

  • Phone Voice — enable or disable Lynx reading responses aloud through your phone's speaker.
  • Theme — Original, Light, or Dark.
  • AI Personality — changes Lynx's conversational style (same options as desktop).
  • Voice Model — the TTS voice used on mobile.
  • Tool Execution — Always Ask or Always Approve (same as desktop).
  • MCP Plugins — toggle plugins on or off. API keys must be configured on the desktop app.
Features

Memory

Lynx has a Long-Term Memory system that stores facts about you across sessions. This means it can remember things like your name, your preferred tools, your OS, your job, or your project context — and use that automatically in future conversations without you having to repeat yourself.

How facts are saved

Every 10 messages within a session, Lynx's Memory Writer runs in the background and analyzes the recent conversation. It extracts facts that meet all of the following criteria:

  • You stated it explicitly in your own words — not an inference.
  • It will likely still be true in 30+ days.
  • It is specific and actionable (e.g. "user builds in Python 3.11 on Windows 11", not "user likes coding").
  • It is genuinely about your identity, environment, preferences, or long-term context.
ℹ️

One-off commands ("open Chrome", "remind me at 5pm"), greetings, and session-specific requests are never saved to memory.

How memory is used

At the start of each session, Lynx retrieves the most relevant saved facts based on what you say in your first message, and injects them into its system context. This makes it aware of your background from the first reply.

Capacity and management

Memory can hold up to 60 facts. When it's full, Lynx will notify you with a message in the chat and stop adding new facts. To free up space, open the Memory page from the sidebar and delete any facts you no longer need.

Stale facts (those that haven't been relevant or updated in a long time) are automatically removed on startup.

Managing your memory

The Memory page shows all stored facts with their text and the original quote from your conversation that was used to save it. You can delete individual facts at any time. Deletion is permanent.

Features

Proactive Intelligence

Lynx watches your activity in the background and can offer suggestions, warnings, and helpful nudges without you having to ask. This is opt-in and fully configurable.

What triggers a suggestion

  • App switch — Lynx notices you switched applications and may offer context-relevant help (e.g. resuming a task you were working on).
  • Error detection — If an error message appears in a window title, Lynx flags it and offers to help immediately (high priority).
  • Struggle detection — Rapid switching between many apps is detected as a sign you might be stuck. Lynx offers to help.
  • System alerts — Low battery, high CPU/RAM usage, low disk space, and network issues trigger health warnings.
  • Temporal patterns — Lynx checks your activity habits every 30 minutes and may suggest routine tasks at the time you normally do them.
  • Morning briefing — Once per day on the first app switch, Lynx gives a brief system health summary.

When Lynx stays quiet

The system is designed to know when not to interrupt:

  • If you're deeply focused in one app for 5+ minutes, Lynx stays silent.
  • If you've dismissed the same suggestion type before, Lynx waits 24 hours before trying again.
  • If you've blocked a suggestion type, it's permanently silenced.
  • If Lynx's confidence in a suggestion is low, it won't deliver it.
  • If your historical acceptance rate for a type drops below 15%, Lynx stops offering it.

Do Not Disturb

You can enable Do Not Disturb mode from Settings to pause all proactive suggestions. Critical system alerts (e.g. critically low battery) will still appear even in DND mode.

Features

MCP Plugins

Lynx supports the Model Context Protocol (MCP) — an open standard for connecting AI assistants to external services. You can install MCP plugins to give Lynx access to tools and data from other platforms.

Available plugins

The following plugins are available in the Plugin Store (accessible from Settings on both desktop and mobile):

GitHub

Gives Lynx access to your GitHub repositories. Requires a GitHub Personal Access Token configured on the desktop app.

Supabase

Connects Lynx to a Supabase project. Useful for querying databases, managing tables, and running backend tasks. Requires a Supabase API key on the desktop app.

Slack

Lets Lynx read and send Slack messages, list channels, and interact with your workspace. Requires a Slack Bot Token on the desktop app.

Linear

Connects Lynx to your Linear workspace for issue tracking and project management. Requires a Linear API key on the desktop app.

Enabling a plugin

  1. Open Settings in the desktop app.
  2. Find the MCP Plugins section and click on a plugin to configure it.
  3. Enter the required API key or token for that service.
  4. Enable the plugin with the toggle. Lynx loads it immediately — no restart needed.
⚠️

API keys can only be configured on the desktop app. The mobile app's Plugin Store lets you toggle plugins on/off but cannot accept API key input for security reasons.

Reference

Settings Reference

All settings are stored locally in a SQLite database. Changes take effect immediately — no restart required.

Setting Options Description
voice_enabled On / Off Enable or disable all TTS voice output from Lynx on the desktop.
wake_word_enabled On / Off Whether saying "Lynx" wakes the voice engine. Requires a Pro plan or above.
voice_model Alex / Ashley / Oliver / Elena / Hades The AI voice used for TTS responses. Applies instantly — no restart needed.
personality Default / Professional / Adviser / Friendly / Strict Changes how Lynx communicates. Affects tone and verbosity, not capability.
theme Original / Light / Dark The visual theme of the desktop app's UI.
permission_mode Always Ask / Always Approve Controls whether Lynx prompts before executing actions on your PC.
mcp_plugins Per-plugin toggle Enable or disable each MCP plugin individually. API keys stored here are desktop-only.