Installation

import { Steps, Aside } from ‘@astrojs/starlight/components’;

System Requirements

Requirement	Details
OS	macOS 11+ or Windows 10+
Architecture	macOS universal (Intel + Apple Silicon), Windows x64
Disk Space	~250 MB
Notes	Apple notarized build on macOS, NSIS installer on Windows

Install on macOS

1. Download the DMG

   Download The Terminal

2. Open the DMG and drag to Applications

   Double-click the downloaded .dmg file, then drag The Terminal into your Applications folder.

3. Launch

   Open The Terminal from Applications or Spotlight (Cmd+Space, type “The Terminal”).

The Terminal is Apple Notarized, so it should open without any Gatekeeper warnings. If macOS blocks it, right-click the app and choose "Open" to bypass the first-launch check.

Install on Windows

1. Download the installer

   Download The Terminal for Windows

2. Run the installer

   Open The-Terminal-latest-win.exe and complete the NSIS setup flow.

3. Launch

   Open The Terminal from the Start Menu.

Auto-Updates

The Terminal checks for updates automatically over HTTPS with signature verification. When a new version is available, you’ll see an update prompt. Updates are incremental — only changed components are downloaded.

In-App Gee Setup (macOS)

If you’re on macOS, you can bootstrap Gee tooling directly from The Terminal:

1. Open Settings (Cmd+Shift+P)
2. Go to Gee Setup
3. Click Check Status
4. Click One-Click Install
5. Run gee-code auth login in a terminal panel

The guided setup checks and installs Homebrew, Python 3.12, Node.js, and gee-code. It also supports optional installs for Claude Code CLI and OpenAI Codex CLI.

Installing Gee-Code Manually

The Terminal is a standalone workspace — you don’t need Gee-Code to use it. But the AI integration features require Gee-Code to be installed.

If you want AI capabilities:

# macOS / Linux
curl -fsSL https://gee-desktop.s3.amazonaws.com/GeeCode/install.sh | bash

# Windows
powershell -ExecutionPolicy Bypass -c "irm https://gee-desktop.s3.amazonaws.com/GeeCode/install.ps1 | iex"

gee-code auth login

Then run gee-code inside a Terminal panel. It will automatically detect The Terminal and connect to the DevTools API.

See the Gee-Code documentation for full installation instructions.

Uninstall

• macOS: Drag The Terminal from Applications to Trash
• Windows: Uninstall from Settings -> Apps -> Installed Apps

To remove configuration files:

rm -rf ~/.the-terminal

Next Steps

• Quick Start — get oriented in 2 minutes