equinox-local

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, explicit Main enrollment, exact-SHA 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

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.

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. The same official installer can be run again over an existing installation to repair or reinstall without discarding your settings. Older large release/component bundles are removed after the new runtime is verified healthy; interrupted replacements retain a guarded recovery path.

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]

• 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. Use Update & restart in Control Center to explicitly join Main; admitted exact-SHA snapshots advance only after platform validation. Documentation-only commits do not trigger runtime updates, and older installed releases follow their own updater behavior. 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 v6.1.2 is the current signed Stable release, with macOS and Windows packages for ARM64 and x64. Equinox Browser v1.0.1 is the extension version in this repository and has been submitted to Chrome Web Store; its Store rollout is controlled by Chrome's review process. The browser updates separately from Local. Download Stable v6.1.2 · Equinox Browser · Product website · Release notes.

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