Install and Setup
Install Jean, connect your preferred backend, and complete the first-run setup.
Jean runs as a native desktop app and works with the CLI tools you already use.
You can use Claude CLI, Codex CLI, OpenCode, or a mix of them. Git is required. GitHub CLI and a Linear API key are optional, but they unlock more of the workflow.
What you need
- Git
- At least one backend: Claude CLI, Codex CLI, or OpenCode
- A Jean install from Homebrew or the coollabsio/jean releases
- Optional: GitHub CLI for issues, PRs, workflows, and security context
- Optional: Linear personal API key for Linear issue flows
Install Jean
brew tap coollabsio/jean
brew install --cask jeanDownload the latest desktop build from coollabsio/jean/releases, then move it into your normal app flow for macOS, Windows, or Linux.
Complete setup
When Jean opens for the first time it checks whether any supported backends are installed.
If none are available, the welcome screen guides you through setup before you can add projects.
In the setup flow you can:
- verify CLI installation status
- authenticate Claude CLI, Codex CLI, GitHub CLI, and OpenCode
- choose where each CLI comes from when path-based installs are available
- set your default backend, model, and other defaults
- decide whether you want Jean to open terminals and editors with your preferred apps
Good default
If you are new to Jean, start with one backend you already trust and add the others later. The app is easier to learn when the first session has fewer moving parts.
Optional tools
- GitHub CLI adds issue, PR, workflow, and security investigation flows.
- Linear API key lets Jean pull Linear issues into the new-session flow.
- Custom Claude CLI provider profiles let you route Claude CLI through alternate endpoints while keeping Jean's workflow intact.
Web access comes later
Headless mode and browser access belong to the runtime side of Jean, not the install step. See the web access guide once the desktop setup is done.