A dev environment for AI agents. Run Claude, Codex, Cursor, OpenCode, Pi, Command Code, Grok, Kimi Code, Antigravity, and Muse in parallel - each in its own git worktree - on your laptop or your own server.
Tauri v2 · React 19 · Rust · TypeScript · Tailwind CSS v4 · shadcn/ui v4 · Zustand v5 · TanStack Query · Pierre Diffs · xterm.js
Jean is an opinionated AI agent workspace. It has strong opinions about how AI-assisted development should work: every task gets its own git worktree, agents run in parallel, and git work, reviews, terminals, and GitHub, Linear, and Sentry integrations live in one cohesive workflow.
Run it as a native desktop app, as a headless jean-server on Linux, or both: the desktop app shows local and remote projects together in one sidebar, grouped by server.
No vendor lock-in. Jean uses your own CLI installations and subscriptions, and everything runs on machines you control.
For more information, take a look at jean.build.
 Recent sessions & parallel agents |
 Built-in terminal |
 Diff review with line comments |
 Magic commands |
 Magic prompts |
 Start from an issue, PR, Linear or Sentry |
- Project & Worktree Management - Multi-project support, linked projects for cross-project context, git worktree automation (create, archive, restore, delete), worktree labels and filters, custom project avatars
- Session Management - Multiple sessions per worktree, Recent tab across all projects, execution modes (Plan, Build, Yolo) with plan approval flows,
/goaltracking, session recap/digest, saved contexts with AI summarization, archiving with retention settings, recovery, auto-naming, canvas views - AI Backends - Claude, Codex, Cursor, OpenCode, Pi, Command Code, Grok, Kimi Code, Antigravity (beta), and Muse. Model selection and thinking/effort levels with per-mode overrides, MCP server support, multi-agent collaboration, file picker & image attachments, chat search, notification sounds, custom system prompts, custom CLI profiles
- Magic Commands & Prompts - Investigate issues/PRs/workflows/security alerts, code review with finding tracking, AI commit messages, PR content generation, merge conflict resolution, release notes generation; every prompt is editable with its own backend, model, effort, and mode
- Mr. Robot (beta) - Polls open GitHub issues, creates one worktree per issue, drafts a plan, and can execute approved plans
- Integrations - GitHub (Issues, PRs, Security Alerts, Advisories, Dependabot, checkout PRs as worktrees, auto-archive on merge), Linear, Sentry, CodeRabbit
- Developer Tools - Multi-dock terminal (floating, left, right, bottom), built-in browser (desktop app), command palette, open in editor (Zed, VS Code, VSCodium, Cursor, Xcode, IntelliJ), git operations (status, stash, revert, fetch/merge with conflict detection), diff viewer (unified & side-by-side) with line comments, file browser with preview and editing (
Cmd/Ctrl+Shift+B), usage and token tracking - Opinionated Plugins - One-click RTK (cuts tool-output tokens 60-90%) and Caveman (terse Claude replies)
- Local + Remote - Add any number of
jean-serverinstances to the desktop app (or install one over SSH); their projects appear next to your local ones and every action runs on the server that owns the project - Web Access - Every Jean instance (desktop or headless server) can serve the full UI over HTTP/WebSocket with token auth, including on phones
- Customization - Themes (light/dark/system), custom fonts, configurable keybindings, mobile swipe gestures
Download the latest version from the GitHub Releases page or visit jean.build.
brew tap coollabsio/jean
brew install --cask jeanPrerequisites:
- Node.js
- Rust
- Windows only: In the Visual Studio Installer, ensure the "Desktop development with C++" workload is selected, which includes:
- MSVC C++ build tools
- Windows SDK (provides
kernel32.liband other system libraries required by Rust)
See CONTRIBUTING.md for full development setup and guidelines.
- macOS: Tested
- Windows: Not fully tested
- Linux: Community tested (Arch Linux + Hyprland/Wayland)
Every Jean instance can run Web Access: an embedded HTTP + WebSocket server that serves the same UI in a browser. That applies to both:
| Mode | How you get Web Access |
|---|---|
| Native desktop (macOS / Windows / Linux) | Settings → Web Access - enable the HTTP server, set port/bind address, copy the token URL |
Headless server (jean-server) |
Always on - the process is the Web Access endpoint |
Use it to open Jean from another machine on your LAN, a phone/tablet browser, or a remote host. Token authentication is on by default; keep it enabled for any non-localhost bind.
Web Access binds a normal TCP port (default 3456). For access beyond the local machine, prefer a private mesh VPN rather than exposing the port to the public internet:
- Tailscale (recommended) - prefer
jean-server --host 127.0.0.1plustailscale serve --bg 3456so the browser gets real HTTPS (clipboard and other secure-context APIs work). Binding the Tailscale IP directly (--host tailscale) is HTTP-only and browsers will treat it as an insecure origin. - Other options: WireGuard, ZeroTier, SSH tunnel, or a reverse proxy with TLS
in front of
127.0.0.1
Keep token auth enabled, use a long random token
(openssl rand -base64 32), and avoid binding 0.0.0.0 on untrusted networks
unless you also terminate TLS and restrict who can reach the port.
- Open Settings → Web Access
- Enable HTTP server (optionally turn on Auto-start)
- Set Port and Bind address (
127.0.0.1for local only, LAN IP,0.0.0.0, or your Tailscale IP) - Open the shown URL (includes
?token=...) in a browser, or share it with devices that can reach that host
The desktop app can work with any number of Jean servers at the same time:
- Open the server menu at the top of the project sidebar → Connections (onboarding also offers this step)
- Click Add remote and either:
- Install via SSH - enter SSH user, host/IP, and ports; Jean installs
jean-serveron that machine for you, or - Existing URL - paste the Web Access URL and access token
- Install via SSH - enter SSH user, host/IP, and ports; Jean installs
- A repository stays one project in the sidebar, even when a checkout exists on more than one Jean. Use the All servers filter to focus the list. Projects that are not the same git remote still group by server.
When you create a worktree or session, Start on lists Local and each
connected remote. If that host does not have the checkout yet, Jean clones it
from the project's git remotes and shows git's clone progress (a percent bar
when git prints one, otherwise a moving bar and the latest git line). It then
asks before copying env files such as .env and .env.local, and the copy
advances file by file. Nothing is synced after that. The host is where the
new worktree or session runs. Uncheck Include in combined dashboard to
hide a server without removing it.
Run Jean as a standalone Linux server with browser Web Access - no desktop window, GTK, or WebView required. Linux amd64 and arm64 only (glibc + OpenSSL 3; Ubuntu 22.04+ / Debian 12+ recommended).
Interactive install (prompts for bind interface + port when a TTY is available):
curl -fsSL https://raw.githubusercontent.com/coollabsio/jean/main/scripts/install-jean-server.sh | sudo bashNon-interactive (defaults to 127.0.0.1:3456, or pass --host / --port):
curl -fsSL https://raw.githubusercontent.com/coollabsio/jean/main/scripts/install-jean-server.sh | sudo bash -s -- -yOr from a clone:
sudo ./scripts/install-jean-server.sh --host 127.0.0.1 --port 3456 -yThe installer downloads the latest release, installs the binary, writes an env
file (host/port/token), and registers a systemd service. Re-run to upgrade;
existing tokens are preserved unless you pass --token.
Common options:
# Public bind with an explicit token
sudo ./scripts/install-jean-server.sh \
--host 0.0.0.0 \
--port 3456 \
--token "$(openssl rand -base64 32)" \
-y
# Tailscale-only bind (auto-detect Tailscale IPv4) - recommended for remote use
sudo ./scripts/install-jean-server.sh --host tailscale -y
# Current user only (user systemd unit)
./scripts/install-jean-server.sh --user-install --host 127.0.0.1 -yjean-server --host 127.0.0.1 --port 3456
# or with an explicit token:
jean-server --host 127.0.0.1 --port 3456 --token "$JEAN_TOKEN"--host accepts localhost, presets (tailscale, lan, 0.0.0.0, …), or
any IP/hostname to bind only that interface. Docker images are also published
as ghcr.io/coollabsio/jean-server.
See docs/headless-server.md for systemd details, reverse proxies, updates, and security notes.
See CONTRIBUTING.md for development setup and guidelines.
| Andras Bacsai |
|---|
 |
   |
Learn more about our approach: Philosophy