https://github.com/coollabsio/jean

A dev environment for AI agents.
https://github.com/coollabsio/jean

agent ai claude-code git parallel worktree

Last synced: 8 days ago
JSON representation

A dev environment for AI agents.

Host: GitHub
URL: https://github.com/coollabsio/jean
Owner: coollabsio
License: apache-2.0
Created: 2026-01-23T07:59:41.000Z (3 months ago)
Default Branch: main
Last Pushed: 2026-04-08T12:11:45.000Z (14 days ago)
Last Synced: 2026-04-08T13:28:31.723Z (14 days ago)
Topics: agent, ai, claude-code, git, parallel, worktree
Language: TypeScript
Homepage: https://jean.build
Size: 12.5 MB
Stars: 808
Watchers: 5
Forks: 78
Open Issues: 76
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yaml
- License: LICENSE.md
- Security: docs/SECURITY.md
- Agents: agents.md

Awesome Lists containing this project

awesome-agent-orchestrators - jean - Desktop & web app for orchestrating coding agents (Claude, Codex, OpenCode) across projects and git worktrees. (Parallel Agent Runners)

README

# Jean

A desktop AI assistant for managing multiple projects, worktrees, and chat sessions with Claude CLI, Codex CLI, and OpenCode.

Tauri v2 · React 19 · Rust · TypeScript · Tailwind CSS v4 · shadcn/ui v4 · Zustand v5 · TanStack Query · CodeMirror 6 · xterm.js

## About the Project

Jean is an opinionated native desktop app built with Tauri that gives you a powerful interface for working with Claude CLI, Codex CLI, and OpenCode across multiple projects. It has strong opinions about how AI-assisted development should work — managing git worktrees, chat sessions, terminals, and GitHub integrations in one cohesive workflow.

No vendor lock-in. Everything runs locally on your machine with your own Claude CLI, Codex CLI, or OpenCode installation.

For more information, take a look at [jean.build](https://jean.build).

## Screenshots

Screenshot 1
Screenshot 2

Screenshot 3
Screenshot 4

Screenshot 5
Screenshot 6

Screenshot 7
Screenshot 8

## Features

- **Project & Worktree Management** — Multi-project support, git worktree automation (create, archive, restore, delete), custom project avatars
- **Session Management** — Multiple sessions per worktree, execution modes (Plan, Build, Yolo), archiving, recovery, auto-naming, canvas views
- **AI Chat (Claude CLI, Codex CLI, OpenCode)** — Model selection (Opus, Sonnet, Haiku), thinking/effort levels, MCP server support, file mentions, image support, custom system prompts
- **Magic Commands** — Investigate issues/PRs/workflows, code review with finding tracking, AI commit messages, PR content generation, merge conflict resolution, release notes
- **GitHub Integration** — Issue & PR investigation, checkout PRs as worktrees, auto-archive on PR merge, workflow investigation
- **Developer Tools** — Integrated terminal, open in editor (Zed, VS Code, Cursor, Xcode), git status, diff viewer (unified & side-by-side), file tree with preview
- **Remote Access** — Built-in HTTP server with WebSocket support, token-based auth, web browser access
- **Customization** — Themes (light/dark/system), custom fonts, customizable AI prompts, configurable keybindings

## Installation

Download the latest version from the [GitHub Releases](https://github.com/coollabsio/jean/releases) page or visit [jean.build](https://jean.build).

### Homebrew (macOS)

```bash
brew tap coollabsio/jean
brew install --cask jean
```

### Building from Source

Prerequisites:

- [Node.js](https://nodejs.org/)
- [Rust](https://www.rust-lang.org/tools/install)
- **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.lib` and other system libraries required by Rust)

See [CONTRIBUTING.md](CONTRIBUTING.md) for full development setup and guidelines.

## Platform Support

- **macOS**: Tested
- **Windows**: Not fully tested
- **Linux**: Community tested (Arch Linux + Hyprland/Wayland)

## Headless Web Access

Run Jean without the desktop window and expose the web UI over HTTP:

```bash
jean --headless --host 127.0.0.1 --port 3456
```

`--host` accepts `localhost` or an IP address. Passing a specific address such
as your Tailscale IP binds Jean only to that interface.

## Roadmap

- Enhance remote web access

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.

## Core Maintainer

| Andras Bacsai |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
| Andras Bacsai |
| |