Installation

Jaade currently ships as a desktop application for macOS. Download the build, install it, and make sure at least one coding agent's credentials are available.

Download

Get the latest release from jaade.app or jaadehq/jaade-public releases.

macOS

Download the .dmg, open it, and drag Jaade into Applications.
The macOS build is signed and notarized.

On first launch Jaade opens with no workspace selected — point it at a project folder to get started (see the Quick Start).

Prerequisites

Jaade drives agent CLIs and SDKs that you authenticate the same way you would at the command line. You don't need all of these — set up the agent(s) you plan to use.

Claude Code

The Claude Code agent works out of the box once Claude is authenticated. You have two options:

• Sign in with Claude. In Settings → Agent, the Sign in with Claude button mints a long-lived claude.ai (Pro/Max) OAuth token via claude setup-token. Once set, in-app Claude sessions authenticate with your subscription instead of an API key.
• API key / environment. Standard ANTHROPIC_API_KEY and related environment variables are honored. AWS Bedrock is also supported via the usual Bedrock environment variables; Jaade can surface an AWS auth-refresh action if a token expires.

You can also point Claude Code at a Claude-compatible third-party provider (Moonshot/Kimi, Zhipu/GLM, DeepSeek, or a custom endpoint) — see Agents configuration.

Codex

Install the Codex CLI and authenticate it as usual. Jaade auto-detects the binary on your PATH (on macOS it also falls back to the Codex app bundle). You can set an explicit path in Settings → Agent if needed.

OpenCode (experimental)

OpenCode requires the opencode CLI installed and available on PATH, and must be enabled under Settings → Features. It needs an app restart after you toggle it on.

Cursor (experimental)

Cursor uses the Cursor SDK and requires a Cursor API key (set in Settings → Agent → Cursor, or via the CURSOR_API_KEY environment variable). Enable it under Settings → Features. A Test connection button validates the key.

Verifying your setup

1. Open a project folder as a workspace.
2. Start a new session and confirm your chosen agent and model appear in the command bar.
3. Send a simple prompt (for example, "list the files in this repo").

If an agent doesn't appear in the picker, check that it's enabled in Settings → Features (for OpenCode/Cursor) and that its CLI/credentials are in place. See Agents configuration for the full list of options.

Building from source

Jaade is open source. To run it from the repository:

npm install
npm run dev          # start the app in development mode
npm run build        # build a production bundle
npm run package      # build and package a desktop app

See the repository's README.md for platform-specific packaging and release details.