v0.1.0 · Open Beta

Chat first.
Voice when you want it.

Gergy is a desktop AI assistant that turns typed requests, dropped files, pasted notes, and optional voice commands into real project execution with Claude, Codex, Copilot, or Gemini.

Chat-first workflow · Optional voice and wake word · macOS & Windows

Gergy

Built for how you actually work

Pick your installed CLI, choose chat or voice, and keep everything grounded in real project folders on your machine.

Any AI CLI, Your Choice

Switch between Claude, Codex, Copilot, and Gemini without changing your workflow. Gergy's adapter layer normalizes all four into a single consistent interface.

Chat-First Input & Uploads

Start with a dedicated chat window, drag files straight into the request, paste screenshots, or drop long notes that Gergy stages directly into the project workspace.

Voice When You Want It

Prefer hands-free control? Enable voice and wake word in onboarding or settings. Prefer chat only? Leave them off and use the same execution engine without the avatar flow.

Guided Setup & Persistent Sessions

First launch walks you through CLI detection, voice preferences, avatar choice, and wake-word settings. Every session stays in SQLite-backed history so you can reopen it later.

Four adapters, one interface

Gergy normalizes Claude, Codex, Copilot, and Gemini into a single consistent execution layer. Switch anytime without changing your workflow.

Anthropic

Claude

Deep reasoning & tool use

The default adapter. Claude's extended context and native tool calling make it ideal for complex, multi-step projects that read and write files.

claude-haiku-4-5claude-sonnet-4-6claude-opus-4-6
OpenAI

Codex

Code-native intelligence

High-reasoning execution in a sandboxed workspace. Codex's native code understanding and execution make it uniquely suited for agentic coding tasks.

gpt-5-codex-minigpt-5.2-codexgpt-5.3-codex
GitHub

Copilot

GitHub subscription included

Use your existing GitHub Copilot subscription. No additional API key required — streaming JSON responses with minimal setup.

claude-haiku-4.5claude-sonnet-4.5gpt-5
Google

Gemini

Multimodal frontier model

Google's latest multimodal model with massive context and structured JSON streaming. Outstanding for research, analysis, and vision tasks.

gemini-2.5-flashgemini-2.5-pro

Install your AI CLI

Gergy works with any supported assistant already installed on your machine. Pick one and follow the steps — it takes under two minutes.

Anthropic

Claude

Deep reasoning & tool use

  1. Install Claude Code
    npm install -g @anthropic-ai/claude-code
  2. Authenticate
    claude
Official docs & account setup
OpenAI

Codex

Code-native intelligence

  1. Install Codex CLI
    npm install -g @openai/codex
  2. Authenticate with Codex CLI
    codex login
  3. Verify
    codex --version
Official docs & account setup
GitHub

Copilot

GitHub subscription included

  1. Install Copilot CLI
    npm install -g @github/copilot
  2. Authenticate
    copilot auth login
  3. Verify
    copilot --version
Official docs & account setup
Google

Gemini

Multimodal frontier model

  1. Install Gemini CLI
    npm install -g @google/gemini-cli
  2. Authenticate
    gemini
Official docs & account setup

Up and running in minutes

Installed CLIs are auto-detected, the welcome flow sets your defaults, and every request can begin in chat without touching a terminal.

$ claude --version
claude 1.x.x
 
cmd+alt+g
▶ New chat opened
 
"Build a landing page and include the screenshots I dropped in."
 
Session #42 · project-landing
✔ Staged attachments in .gergy/attachments
✔ Started Codex execution
✔ Preview ready at localhost:8080
01

Install an AI CLI

Pick any supported assistant: claude, codex, copilot, or gemini. Gergy auto-detects what's available on your PATH.

02

Launch the welcome flow

On first run, Gergy detects installed CLIs, defaults to the first one it finds, and lets you decide whether to enable voice or stay chat-first.

03

Describe the request in chat

Open a dedicated chat window, describe what you want, and optionally drag in files, paste images, or drop long notes that should live in the project folder.

04

Watch it execute

Gergy binds the request to a project, starts the selected CLI, streams execution activity live, and opens a preview or folder view whenever you need it.

Download Gergy

Download the desktop app, install one supported CLI, and choose chat-only or voice-enabled control during first-run setup.

macOS
10.15 Catalina or later
Download DMG (Apple Silicon)
Also available: Intel Mac DMG
macOS Gatekeeper notice

Open the .dmg and drag Gergy.app to Applications. If macOS says the app is damaged or unverified, open Terminal and run:

xattr -cr /Applications/Gergy.app

Then double-click the app to launch normally.

Windows
Windows 10 / 11 (64-bit)
Download Installer
 
Windows SmartScreen notice

Edge or SmartScreen may warn the file is unrecognized. Click Keep in the download bar, then Keep anyway in the SmartScreen prompt to proceed with installation.

Requires at least one AI CLI installed on your system. Use the install guide above to set up Claude, Codex, Copilot, or Gemini.