关于项目

Jean是一款基于Tauri构建的意见型原生桌面应用，它为您提供了一个强大的界面，以便在多个项目中使用Claude CLI、Codex CLI和OpenCode。Jean对AI辅助开发的工作方式有着明确的观点——在一个连贯的工作流中管理Git工作树、聊天会话、终端和GitHub集成。

无厂商锁定。所有内容都在您本地机器上运行，使用您自己的Claude CLI、Codex CLI或OpenCode安装。

更多信息，请访问jean.build。

截图

功能

• 项目与工作树管理 — 多项目支持，Git工作树自动化（创建、归档、恢复、删除），自定义项目头像
• 会话管理 — 每个工作树可有多个会话，执行模式（计划、构建、随心所欲），归档、恢复、自动命名、画布视图
• AI聊天（Claude CLI、Codex CLI、OpenCode） — 模型选择（Opus、Sonnet、Haiku），思考/努力级别，MCP服务器支持，文件提及、图像支持、自定义系统提示
• 魔法命令 — 调查问题/PR/工作流程，代码审查并跟踪发现，AI提交信息，PR内容生成，合并冲突解决，发布说明
• GitHub集成 — 问题与PR调查，将PR检出为工作树，在PR合并时自动归档，工作流程调查
• 开发者工具 — 集成终端，打开编辑器（Zed、VS Code、Cursor、Xcode），Git状态，差异查看器（统一与并排），带预览的文件树
• 远程访问 — 内置HTTP服务器，支持WebSocket，基于令牌的身份验证，可通过网页浏览器访问
• 定制化 — 主题（亮色/暗色/系统），自定义字体，可定制的AI提示，可配置的快捷键

安装

从GitHub Releases页面下载最新版本，或访问jean.build。

Homebrew (macOS)

brew tap coollabsio/jean
brew install --cask jean

从源码构建

前提条件：

• Node.js
• Rust
• 仅限Windows：在Visual Studio Installer中，确保选择了“使用C++进行桌面开发”工作负载，其中包括：
  • MSVC C++构建工具
  • Windows SDK（提供kernel32.lib和其他Rust所需的系统库）

完整开发设置和指南请参阅CONTRIBUTING.md。

平台支持

• macOS：已测试
• Windows：未完全测试
• Linux：社区测试过（Arch Linux + Hyprland/Wayland）

无头Web访问

在不显示桌面窗口的情况下运行Jean，并通过HTTP暴露Web UI：

jean --headless --host 127.0.0.1 --port 3456

--host可以接受localhost或IP地址。传递特定地址，例如您的Tailscale IP，会将Jean仅绑定到该接口。

路线图

• 增强远程Web访问

贡献

开发设置和指南请参阅CONTRIBUTING.md。

核心维护者

Andras Bacsai

理念

了解更多关于我们方法的信息：理念

星标历史

Jean 快速上手指南

Jean 是一款基于 Tauri v2 构建的本地桌面 AI 助手，旨在统一管理多个项目、Git Worktree 以及聊天会话。它支持 Claude CLI、Codex CLI 和 OpenCode，提供无厂商锁定的本地化 AI 开发工作流。

环境准备

在开始之前，请确保您的系统满足以下要求：

系统支持

• macOS: 已全面测试（推荐）
• Linux: 社区测试通过（如 Arch Linux + Hyprland/Wayland）
• Windows: 尚未完全测试，需额外配置

前置依赖（仅源码编译时需要）

如果您直接下载安装包可跳过此步。若需从源码构建，请安装：

• Node.js
• Rust
• Windows 用户特别注意：安装 Visual Studio 时，务必勾选 "Desktop development with C++" 工作负载（包含 MSVC C++ 构建工具和 Windows SDK）。

安装步骤

方式一：macOS (Homebrew)

推荐使用 Homebrew 进行快速安装：

brew tap coollabsio/jean
brew install --cask jean

方式二：通用安装 (Windows/Linux/macOS)

访问 GitHub Releases 或官网 jean.build 下载对应系统的最新安装包进行安装。

提示：目前官方未提供中国镜像源，如遇下载缓慢，建议配置网络加速工具或使用 GitHub 加速服务下载 Release 文件。

方式三：源码构建

克隆仓库并运行构建命令（需先安装上述前置依赖）：

git clone https://github.com/coollabsio/jean.git
cd jean
# 具体构建命令请参考项目根目录的 CONTRIBUTING.md

基本使用

1. 启动与初始化

安装完成后启动 Jean 应用。首次使用时，确保您的本地环境中已安装并配置好以下任一 CLI 工具：

• claude (Claude CLI)
• codex (Codex CLI)
• opencode (OpenCode)

Jean 会自动检测本地安装的 CLI 工具。

2. 管理项目与 Worktree

• 添加项目：在界面中导入现有的 Git 项目。
• 创建 Worktree：利用内置的 Git Worktree 自动化功能，为当前项目创建独立的开发分支环境（支持创建、归档、恢复和删除）。
• 多会话管理：每个 Worktree 支持多个独立的 AI 聊天会话，可分别设置为 "Plan"（规划）、"Build"（构建）或 "Yolo"（直接执行）模式。

3. 开始 AI 对话

在选定的会话窗口中：

• 选择模型（如 Opus, Sonnet, Haiku）。
• 直接在聊天框中提及文件（File Mentions）或上传图片。
• 使用 Magic Commands 执行高级任务，例如：
  • 调查 Issue 或 PR
  • 生成 AI 提交信息
  • 解决合并冲突
  • 生成发布说明

4. 远程无头模式 (Headless Mode)

如果您希望通过浏览器远程访问 Jean 界面，可在终端运行以下命令启动无头服务：

jean --headless --host 127.0.0.1 --port 3456

启动后，在浏览器中访问 http://127.0.0.1:3456 即可使用 Web 版界面。您也可以将 --host 替换为具体的局域网 IP 或 Tailscale IP 以允许远程连接。