Repository consolidation in progress (approved 2026-10-27): The Astro/Cloudflare website now lives in
website/, and Cloudflare production now builds itswebsite/directory directly from this public repo’smain. The old site repository remains a rollback-only source until full migration acceptance. The long-term distribution goal is one signed Main commit stream and the same external installer for install, update and repair, with version numbers manually selected for presentation and occasional GitHub Releases. See the approved migration plan. This transition does not change the active production updater or public URLs until their acceptance checks pass.
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
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 Local v6.2.0 and Equinox Browser v1.1.0 are unreleased source candidates, not currently distributed. Equinox Browser v1.0.1 is the latest Store-installed extension; any newer rollout is controlled by Chrome Web Store review. 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.
