Equinox Local

Your AI assistant. Your computer. Your control.

A local-first bridge that lets ChatGPT work with your files, terminal, browser and desktop — with a native Control Center and explicit user permissions.

Get started · Features · How it works · Documentation · Contribute

---

What you can do

ChatGPT runs in the cloud; your projects and apps often don't. Equinox Local connects them through an outbound OpenAI Secure MCP Tunnel, keeping Control Center private on your computer. It works with a companion Chrome extension, Equinox Browser, for browser interactions.

🗂️ Projects & terminal Search and edit local projects, run commands and tests, and manage bounded processes using your normal user permissions.	🌐 Browser automation Work in an isolated Agent Browser or, when explicitly selected, Your Browser. Both use the same Chrome extension and consent controls.
🔁 Tasks that survive interruptions Task Capsules, Auto Continue and Fresh Chat Resume preserve the next steps of long-running work without replaying uncertain actions.	💬 Telegram, when you want it Open a new ChatGPT task, continue a bound conversation, receive answers and manage tasks from your private bot chat.
🖥️ Native Control Center See health, review activity, adjust agent access, manage tasks and check updates. Desktop automation is optional.	🛡️ Verified updates Signed Stable bootstrap, automatically enrolled Main snapshots, health checks and rollback. Browser extension updates stay with Chrome Web Store.

Important

Local-first is not a sandbox. Enabling Terminal lets an agent run commands with your signed-in operating-system account's permissions, including outside selected project folders. Review agent access, use Emergency Stop when needed, and read the security model.

Install Equinox Local

macOS · Apple silicon & Intel

Run as your normal user (not with sudo):

curl -fsSL https://local.sametbasbug.dev/downloads/updates/install-equinox-local.sh | /bin/bash

The installer validates its signed release payload and sets up the native app and per-user runtime. No separate Node, Homebrew, Git or Peekaboo installation is required.

Windows · ARM64 & x64

Download the official PowerShell installer and review/run it in PowerShell, or follow the Windows installation guide. The installer provisions the verified release and required tools; a separate Node or Git installation is not needed.

After installation: Open Equinox Local's Setup, create an OpenAI Secure MCP Tunnel and a restricted runtime key, connect the same tunnel in ChatGPT, then install and enable Equinox Browser in Chrome. Setup walks you through each step and verifies the connection before unlocking Control Center.

Requirements: a supported macOS or Windows ARM64/x64 device, Chrome, network access and a ChatGPT plan/workspace that supports the required custom MCP connection. Telegram is optional. See connection instructions and Browser setup.

How it works

flowchart LR
    U[You in ChatGPT] --> T[Secure MCP Tunnel]
    T --> L[Equinox Local]
    L --> F[Files + terminal]
    L --> C[Control Center]
    L --> B[Equinox Browser]
    B --> A[Agent Browser]
    B --> Y[Your Browser, opt-in]

Loading

• Human-controlled: Control Center stays on loopback and exposes status, settings, agent access and Emergency Stop.
• Browser-aware: Your personal Chrome profile and the isolated Agent Browser keep separate state; the system never silently switches between them.
• Resumable, not reckless: guarded browser delivery avoids automatically repeating a message when its send outcome is uncertain.
• One update stream: the installer starts from a signed Stable baseline and automatically enrolls Main. Admitted exact-SHA snapshots advance only after four-platform CI; existing Stable users will be moved with one signed migration bridge. Updating Local never sideloads the Chrome extension.

Read the architecture, Browser, updates and security guides for the implementation details.

Documentation

Guide	What you'll find
Install & connect · Tunnel setup	Supported systems, onboarding and ChatGPT connection
Equinox Browser	Agent Browser vs Your Browser, permissions, controls
Telegram & tasks	Private bot pairing, new tasks, chat continuation, commands
Architecture	How the runtime, UI, MCP gateways and native platforms fit together
Security model · Security reports	Permissions, trust boundaries, responsible disclosure
Updates & rollback	Stable vs Main, signatures and recovery
Contributing · Changelog	Local development, tests, release history
Migrating to 5.0	Historic major-version transition notes

For developers

This is the canonical public source for Equinox Local, Equinox Browser, native macOS/Windows shells, installers and tests. The optional private factory tooling is not another product fork; production and factory environments consume verified canonical source while keeping local configuration and credentials outside Git.

git clone https://github.com/sametbasbug/equinox-local.git
cd equinox-local
npm ci
npm run check
npm run test:fast

See CONTRIBUTING.md for the supported Node version, full test suite, Windows prerequisites and PR guidance. Please use the issue templates for problems or improvements, and private vulnerability reporting for security issues.

Releases & license

Equinox Local 6.0.3 is the current Stable release, paired with Equinox Browser 1.0.0 on Chrome Web Store. Stable packages cover macOS and Windows on ARM64 and x64. Latest release · Product website · Release notes.

Licensed under AGPL-3.0-only. Contributions are welcome; see CONTRIBUTING.md and CODE_OF_CONDUCT.md.