How do I install Equinox Local?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Equinox Local need an API key?

No required environment variable is listed on this record.

What transport does Equinox Local use?

Equinox Local runs locally over stdio.

When was Equinox Local last checked?

Last checked 2026-10-28. Local-first AI workspace for ChatGPT: MCP tunnel, native macOS/Windows control, browser automation, Telegram tasks and signed updates.

Servidor MCP Equinox Local

Potencialize seu agente

Adicionar este servidor

Install from the publisher. Not a PlugMCP endpoint.

Rodar no PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Rodar no PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Abrir

Server facts

Local

Transport: stdio
License: AGPL-3.0
Last checked: 2026-10-28

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Repository consolidation in progress (approved 2026-10-27): The Astro/Cloudflare website now lives in website/, and Cloudflare production now builds its website/ directory directly from this public repo’s main. 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

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 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.