Getting Started

Install the server, start it, and connect a client.

Mobile apps coming soon. Signed desktop releases, iOS, and Android are on the way. You can also build the iOS app locally — requires Rust and Xcode.

Tools require Node.js or Bun. Installed automatically if needed.

Install the server

Jean2 is a single binary. No runtime, no containers, no dependencies.

macOS / Linux

curl -fsSL https://jean2.ai/install.sh | bash

Windows

irm https://jean2.ai/install.ps1 | iex

This downloads the binary to ~/.jean2/bin and adds it to your PATH.

Initialize

jean2 init

This walks you through the first-time setup — default agent configs, recommended tools, and creates ~/.jean2/ as your config directory.

Start the server

jean2 start

The server starts as a background daemon on http://localhost:8742. It prints an API token — copy it, you'll need it to connect your client.

If you missed the API token during startup, retrieve it anytime:

jean2 auth show

Connect a client

Browser (any platform)

No install needed. Run directly from npm:

npx @jean2/client

Open the URL it prints and paste your API token.

macOS

Download the latest release from GitHub Releases.

The app is unsigned. macOS will quarantine it — remove the quarantine attribute:

xattr -cr /Applications/Jean2.app

Paste your API token when prompted.

Windows

Download the latest release from GitHub Releases.

The app is unsigned — Windows Defender SmartScreen will block it. Click More info then Run anyway to proceed.

Paste your API token when prompted.

Linux

There is no native desktop client yet. Use the browser client:

npx @jean2/client

Updating

Server

jean2 update

This pulls the latest version, replaces the binary, and restarts the server. Any database migrations run on startup automatically.

Client

Download the latest release from GitHub Releases and replace the old app. Settings and tokens are preserved.

Tools

Check for available updates:

jean2 tools outdated

Update all installed tools:

jean2 tools update