Tessera
为 Claude Code、Codex 和 OpenCode 打造的本地控制室：并行会话、隔离 worktree、看板、Git 与手机远程访问，一站式管理 AI 编程工作流。
证据显示本地优先设计：默认绑定 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。
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。
目标用户（个人本地并行 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。
文档结构清晰（安装、首启、环境变量、隐私、路线图、许可证），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。
产品聚焦会话可见性、上下文保持与 Git 闭环，输出可用性论证充分，output_usability 3；'并行 session + 隔离 worktree + 看板'相对裸终端有明确增量价值，marginal_value 3；本地运行无 API 成本，但成本收益缺少量化或对比说明，cost_benefit 2。
多数声明可对应到仓库内文件（脚本、工作流、测试），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 等外向操作，文档未说明确认/审批机制，生产使用前请确认工作目录与凭证隔离。
- 远程访问（移动配对）功能细节在所提供文件中不可见，暴露网络前应审查其认证实现。
这个 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。
- 同时推进多个独立编码任务的开发者，需要每个任务有隔离的 Git worktree，避免代理在相同分支上冲突。
- 使用多种 CLI 代理（Claude Code、Codex、OpenCode）并希望在同一个工作区混合 PTY 与 GUI 会话的工程师。
- 希望在手机上查看和继续编程会话、切换 PTY 到 Chat View 的移动办公者。
- 需要将代理任务从 Chat 到 Done 的看板流转，并就地完成提交、同步和 PR 的团队个人工作流。
- 使用 Codex 生成图像并在会话内管理图像参考输入与提示词的创作者。
- 希望由主代理自动编排并行工作代理、等待结果并追加提示的高级用户。
这个 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？
三种方式：
- 桌面应用：从 GitHub Releases 下载——Windows（含 WSL）便携 .exe（未签名，SmartScreen 可能警告）；macOS .dmg（Apple Silicon 或 Intel，已签名公证）；Linux beta .deb。
- 浏览器运行时：需 Node.js 20.9+（20.x）或 22–26 及 npm 10+：
npm install -g @horang-labs/tesseratessera
打开打印的本地 URL。
- 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 定制配置。