Tessera

为 Claude Code、Codex 和 OpenCode 打造的本地控制室:并行会话、隔离 worktree、看板、Git 与手机远程访问,一站式管理 AI 编程工作流。

Star 数
★ 315
最近更新
3 天前
License
AGPL-3.0
主语言
TypeScript

30 秒速览

运行形态
桌面应用命令行工具自托管服务
可在哪里用
通用 · 跨平台Codex · Claude Code
费用
软件免费,模型调用费用自付
上手难度
中 · 需要几步配置
开始前需要
Node.js 20.9+(20.x)或 Node.js 22-26npm 10+Docker(可选)提供商 CLI:Claude Code、Codex 或 OpenCodeShell / 命令行网络访问本地文件系统
典型场景
同时推进多个独立编码任务的开发者,需要每个任务有隔离的 Git worktree,避免代理在相同分支上冲突。
不适合
  • 希望开箱即用、无需自行安装并认证供应商 CLI 的用户
  • 需要团队协作或企业治理能力的团队:相关功能仍在设计伙伴阶段

这个 Agent 能做什么,适合哪些场景?

Tessera 是 horang-labs 开发的开源(AGPL-3.0)本地工作区,用于组织跨项目、集合、标签页、分屏面板和 Git worktree 的 AI 编程会话。它将多个终端整合为可视化工作流,每个任务可拥有独立会话和隔离 worktree,避免代理互相踩踏同一分支。用户可混合运行 Claude Code、Codex 和 OpenCode 的 PTY 或 GUI 模式会话,包括自定义模型 ID。内置 Kanban 看板覆盖 Chat、Todo、Doing、Review、Done 五个阶段,并支持文件编辑、diff 检查、提交、同步、发布分支和创建拉取请求。它以 Electron 桌面应用、npm 浏览器运行时或 Docker Compose 部署,数据默认存储在本地 ~/.tessera/ 目录,并通过手机远程访问继续会话。

Tessera 读取已安装并认证的 Claude Code、Codex、OpenCode CLI,在其上启动 PTY 或 GUI 会话并保持对话、工具调用和状态可见。通过 /tessera-cli 命令,主代理可执行 status、worktree create、session launch、session wait/read、session prompt 等操作来创建隔离 worktree、并行启动会话、等待结果并发送后续提示。Kanban 看板以拖拽方式跟踪任务,实时显示代理与 diff 状态。会话内提供 Chat View 将 PTY 终端转为可读线程,Codex 会话的 Images 标签页可查看生成图像及其参考输入和提示词。文件与 Git 面板支持编辑、查看 diff、选择性提交、同步、发布分支和打开 PR。移动端通过 Settings → Remote access 配对设备,可继续 PTY/GUI 会话并将 PTY 切换到 Chat View。

  1. 同时推进多个独立编码任务的开发者,需要每个任务有隔离的 Git worktree,避免代理在相同分支上冲突。
  2. 使用多种 CLI 代理(Claude Code、Codex、OpenCode)并希望在同一个工作区混合 PTY 与 GUI 会话的工程师。
  3. 希望在手机上查看和继续编程会话、切换 PTY 到 Chat View 的移动办公者。
  4. 需要将代理任务从 Chat 到 Done 的看板流转,并就地完成提交、同步和 PR 的团队个人工作流。
  5. 使用 Codex 生成图像并在会话内管理图像参考输入与提示词的创作者。
  6. 希望由主代理自动编排并行工作代理、等待结果并追加提示的高级用户。

如何安装或部署这个 Agent?

三种方式:

  1. 桌面应用:从 GitHub Releases 下载——Windows(含 WSL)便携 .exe(未签名,SmartScreen 可能警告);macOS .dmg(Apple Silicon 或 Intel,已签名公证);Linux beta .deb。
  2. 浏览器运行时:需 Node.js 20.9+(20.x)或 22–26 及 npm 10+:
npm install -g @horang-labs/tessera

tessera
打开打印的本地 URL。

  1. Docker Compose:
mkdir -p data/config data/local data/ssh data/codex data/tessera workspaces
touch data/gitconfig
docker compose up --build -d

打开 http://127.0.0.1:32123。若绑定挂载不可写:sudo chown -R 1000:1000 data workspaces

如何使用这个 Agent?

首次运行时按引导完成:1) 为浏览器运行时创建本地账户;2) 确认支持的 CLI 已安装并认证(如 claude login、codex login 或 OpenCode 的提供商凭据);3) 选择项目文件夹;4) 启动聊天或基于 worktree 的任务。之后可在会话中调用 /tessera-cli 让主代理编排并行会话;用看板拖拽推进任务状态;在 PTY 会话头部点击聊天图标切换 Chat View;通过 Settings → Remote access 配对手机;用环境变量 TESSERA_DATA_DIR、PORT、TESSERA_HOST、LOG_LEVEL、CLAUDE_CONFIG_DIR 定制配置。

这个 Agent 有哪些优点和局限?

优点
  • Git worktree 隔离使多个代理可并行工作而不冲突分支,这是区别于单会话终端的核心能力。
  • 同一工作区支持 Claude Code、Codex 和 OpenCode 三家 CLI 的 PTY 与 GUI 模式,避免提供商锁定单一工具。
  • 通过 /tessera-cli 让主代理自动创建 worktree、启动并行会话并协调结果,实现多代理编排。
  • 从文件编辑、diff 审查到提交、发布分支和打开 PR 的完整 Git 闭环,无需切换应用。
  • 手机远程访问和 PTY Chat View 提供跨设备的会话连续性。
局限
  • 依赖本机已安装并认证的提供商 CLI(claude login、codex login 等),无法脱离这些 CLI 使用。
  • Windows 构建尚未代码签名,SmartScreen 会显示未知发布者警告;Linux 仅提供 beta 版 .deb。
  • 发布版本包含匿名产品交互遥测,需在引导或设置中主动关闭。
  • 目前聚焦个人本地工作流,团队和企业功能仍在筹备中,需加入设计伙伴等待名单。
  • 浏览器运行时要求较新的 Node.js 版本(20.9+ 20.x 或 22–26)及 npm 10+。

这个 Agent 与同类方案有什么区别?

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Tessera 当前 74 · 存在缺口 桌面应用免费 + 模型费 ★ 315 3 天前 TypeScript Codex · Claude Code
Nimbalyst 可视化智能编码工作台 50 · 缺口较多 桌面应用免费 + 模型费 ★ 2k 今天 TypeScript Codex · Claude Code
Cezar — AI 编码代理编排器 63 · 存在缺口 命令行工具免费 ★ 827 今天 TypeScript Codex · Claude Code
Vicoa 52 · 缺口较多 桌面应用免费 + 模型费 ★ 522 1 天前 Python Codex · Claude Code

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
存在缺口
74/ 100 五分制 3.7 / 5
信任安全 18/29
可靠稳定 9/14
适用触发 15/18
规范维护 15/18
有效结果 12/13
证据核验 5/8
查看各维度的扣分理由
信任安全18 / 29 · 3.1/5

证据显示本地优先设计:默认绑定 127.0.0.1、数据存于 ~/.tessera、遥测可关闭且明确列出排除项,故 least_privilege、data_flow_transparency、sensitive_data_handling 给 2;但 agent 写文件、提交、发布分支、发 PR 等动作缺少用户确认机制的文档证据(治理功能仅出现在路线图),user_confirmation 仅 1;rollback 无任何备份/恢复说明,给 1;依赖被精确固定且含 node-pty/better-sqlite3 等原生件,但无审计或 lockfile 证据,dependency_security 2;依赖已安装并经认证的 provider CLI、git 副作用在 UI 内可见,external_effects 2;作者、仓库、许可证归属清晰,source_attribution 3。

可靠稳定9 / 14 · 3.2/5

README 与 package. 基本一致,但存在小矛盾:package. 版本 0.2.3 而 README 引用 v0.2.4 的发布资产,SECURITY.md 是未填写的模板(支持版本写 5.1.x,与实际 0.2.x 不符),self_consistency 因此扣至 2;engines 明确、Docker 与 npm 双路径有说明,dependency_availability 2;测试展示对失败路径(GUI 关闭失败不阻断 PTY、WSL 探针失败不缓存)的细致处理,failure_messages 2。

适用触发15 / 18 · 4.2/5

目标用户(个人本地并行 agent 工作流)与场景(Claude Code/Codex/OpenCode、PTY/GUI、移动端)描述充分,audience_and_scenarios 3;明确声明'目前聚焦个人本地工作流',capability_boundaries 2;/tessera-cli 的触发方式与代表性子命令有列出但无完整参考文档,trigger_precision 2;对 Windows/macOS/Linux/WSL/Docker 的适配及 WSL 路径桥接的测试覆盖非常突出,environment_fit 3。

规范维护15 / 18 · 4.2/5

文档结构清晰(安装、首启、环境变量、隐私、路线图、许可证),information_architecture 3;三种安装路径(桌面、npm、Docker)含具体命令和排障提示,install_notes 3;命名稳定(tessera、@horang-labs/tessera),naming_stability 3;无 FAQ,示例以动图为主、缺少命令级示例,examples_and_faq 2;已知限制仅提到 Windows 未签名,known_limitations 2;AGPL-3.0 全文附上且 package. 一致,license 3;无 CHANGELOG 文件,仅见 docs/releases 约定,versioning_changelog 2;有维护者联系和发布流水线,但 SECURITY.md 模板未填写削弱可维护性证据,maintenance_responsibility 2。

有效结果12 / 13 · 4.6/5

产品聚焦会话可见性、上下文保持与 Git 闭环,输出可用性论证充分,output_usability 3;'并行 session + 隔离 worktree + 看板'相对裸终端有明确增量价值,marginal_value 3;本地运行无 API 成本,但成本收益缺少量化或对比说明,cost_benefit 2。

证据核验5 / 8 · 3.1/5

多数声明可对应到仓库内文件(脚本、工作流、测试),claim_traceability 2;README、package.、CI 工作流相互印证大部分事实,但版本号小错和 SECURITY.md 模板构成不一致点,cross_source_corroboration 2;遥测'不收集提示词/路径'等声明是静态无法验证的断言,与事实陈述的区分尚可但未系统标注,fact_inference_separation 2。

风险与缓解建议
  • SECURITY.md 为未填写的模板,漏洞报告渠道与支持版本不可信,请通过仓库 Issues 核实。
  • package. 版本 (0.2.3) 与 README 引用的发布资产 (v0.2.4) 不一致,安装时请核对实际发布标签。
  • Windows 桌面构建未代码签名,SmartScreen 会警告未知发布者;发布者身份未经企业注册库验证。
  • 遥测默认开启(可在引导或设置中关闭),静态审查无法验证'不收集提示词/路径'的声明,敏感环境用户应自行评估或直接禁用。
  • agent 可执行 git 提交、推送分支、开 PR 等外向操作,文档未说明确认/审批机制,生产使用前请确认工作目录与凭证隔离。
  • 远程访问(移动配对)功能细节在所提供文件中不可见,暴露网络前应审查其认证实现。
证据充分度:低 评估于 2026年9月10日 审查版本 27a29477a9e1 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v0.2.4
    发布说明摘录
    Tessera v0.2.4 Review generated images, work across sessions, and manage projects across branches. Highlights - Projects & Worktrees — See your project's Sessions across branches and switch branches without leaving Tessera ![Filter Sessions by branch](https://raw.githubusercontent.com/horang-labs/tessera/04673461/docs/assets/releases/v0.2.4/branch-filter.png) ![Choose a checkout branch](https://raw.githubusercontent.com/horang-labs/tessera/56e3b2de/docs/assets/releases/v0.2.4/branch-switch.png) - Session creation — Start a new Session in a Worktree you already use …
    在 GitHub 查看 ↗
  2. v0.2.3
    发布说明摘录
    Tessera v0.2.3 Let agents operate Tessera itself, use Tessera from your phone, and ship changes from the Git panel. Highlights - Tessera CLI — Lets agents operate Tessera itself—for example, create isolated Worktrees and Sessions for multiple tickets, monitor progress, and coordinate parallel delivery. Use: enable it in Settings → Development, then invoke /tessera-cli in a managed agent Session - Key commands: tessera status, tessera worktree create, tessera session launch, tessera session wait, tessera session read, tessera session prompt …
    在 GitHub 查看 ↗
  3. v0.2.2
    发布说明摘录
    Tessera v0.2.2 Run coding agents in a real terminal, preview sessions with Kanban Peek, and a Windows/WSL optimization pass. Highlights Coding Agents in Terminal Mode ![Coding agent in terminal (PTY) mode alongside the GUI](https://raw.githubusercontent.com/horang-labs/tessera/main/docs/assets/readme/pty-gui-side-by-side.png) Everything Tessera already does stays — now you can also run agents in a real terminal. - Run Claude Code, Codex, and OpenCode in a real terminal (PTY) — TUI and all, not just headless …
    在 GitHub 查看 ↗
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关 Agents