mind code
Browse documentation

Installation

Mind is available as a desktop IDE, a command-line interface, and a web app. Pick the surface that fits your workflow. You can use more than one, and your .mind configuration is shared across all of them.

System requirements

IDE — macOS (Intel + Apple Silicon), Windows 10/11 (64-bit), or Linux (Ubuntu 24+, Debian 13+, Fedora 40+, Arch, Mint 22+).

CLI — macOS or Linux (glibc 2.34+ or musl variant). On Windows, through WSL.

Web — Any modern browser. No local installation required.

Fleet — macOS, Linux (x86_64 and ARM), or Windows. Python 3.9+ required for source installs.

Install Mind

Download Mind

Go to mindcode.sh and download the installer for your operating system (macOS, Windows, or Linux).

Run the installer

Open the downloaded file and follow the installation instructions for your platform.

Sign in

When you open Mind for the first time, sign in with GitHub or a passkey. Learn more about authentication.

Import settings (optional)

You can import your VS Code settings, keybindings, and extensions. If you use another editor, skip this step and select your preferred theme.

Open a project

From the welcome page, open a folder to start your first session. See Your first project for a guided walkthrough.

Upgrading

Mind IDE downloads updates automatically in the background. When an update is ready, you will see a notification to restart and apply it.

To check manually, open the Mind menu and select Check for Updates... On Windows or Linux, open the Command Palette (Ctrl + Shift + P) and run Mind: Check for Updates.

Downgrade to a previous version

You can revert to an earlier version of Mind IDE if an update introduces issues:

  1. Go to the downloads page.
  2. Scroll past the main download cards to the version list.
  3. Expand the version you want to install (for example, "IDE 1.0.x").
  4. Download the installer for your platform.
  5. Uninstall your current version:
    • macOS: drag Mind from Applications to the Trash
    • Windows: uninstall from Settings > Apps > Installed apps
    • Linux: run sudo apt remove mind
  6. Run the downloaded installer.

Your settings, extensions, and sign-in state are preserved across reinstalls.

Uninstalling

Uninstall Mind IDE using your operating system's standard application removal process (drag to Trash on macOS, Apps & Features on Windows, or your package manager on Linux).

Proxy configuration

Mind respects standard proxy environment variables (HTTP_PROXY, HTTPS_PROXY, NO_PROXY) on both the IDE and the CLI. Set these in your shell:

export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080
export NO_PROXY=localhost,127.0.0.1,.company.com

For proxies that require authentication:

export HTTPS_PROXY=http://<username>:<password>@proxy.company.com:8080

In addition to the environment variables, you can configure proxy settings in Settings > Proxy inside Mind.

Browser-based sign-in bypasses proxy settings

When you sign in, Mind opens your default browser. This browser traffic uses your operating system's network stack, not the IDE's proxy configuration.

For the full reference, including URLs to allowlist and data perimeter guidance, see Firewalls, proxies, and data perimeters.

Troubleshooting

Common troubleshooting solutions for Mind IDE installation, shell integration, and macOS/Windows setup:

macOS: "Mind is damaged and can't be opened"

Due to macOS Gatekeeper quarantine false positives on new downloads, run this command in Terminal:

sudo xattr -d com.apple.quarantine /Applications/Mind.app

Windows: PowerShell script execution blocked

If PowerShell blocks execution of scripts or shell integration, set your execution policy:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Terminal Shell Integration Unavailable

Open Command Palette (Cmd + Shift + P) and run Mind: Enable Shell Integration, then restart the IDE.

For network connectivity, corporate TLS proxy firewalls, and MCP server debugging, see the full IDE troubleshooting guide.

Next steps