前排围观传送门:github.com/pingdotgg/t…
这玩意儿到底是个啥
Theo(做 t3.gg、全网粉丝一大把的那个 Theo)做的开源货。一句话简介:编码 Agent 的开源「控制面」。Claude Code、Codex、Cursor、OpenCode、Grok Build、Antigravity、Kiro 还有任何走 ACP 的 Agent,只要在你机器上装好并登录了,t3code 就能统一管起来。
和隔壁 Orca 一样,它反复强调一件事——不转卖 token,跑的就是你自己已经登录的订阅。README 里甚至专门有节标题叫 “Wait, what are you selling me?” ,答案是 “Nothing.”(啥也不卖,做这个纯粹是因为他们自己没找到满意的)。
它想解决的场景很具体:你在工位开一个 thread 让 Agent 干活,离开工位后它卡在一个「要不要执行这条命令」的确认上,手机上一审批,它就接着跑。 桌面开干、手机续命。
功能全景
- 用你自己的订阅:不抽成,驱动你已登录的 Agent。
- 所有 Agent 一个界面:thread 中途换模型都行,还能让 Claude 把活甩给 Codex。
- 桌面 / Web / 手机同一个 server:一台 server,所有客户端看到同一批 thread,iOS 和安卓都有 App。
- 天生远程:Agent 想在哪跑就在哪跑,走局域网、Tailscale 或它家的 T3 Connect 连。
- Git 内置:每个 thread 可在自己 worktree 干活,看 diff、一键 commit / push / 开 PR。
- 性能偏执:README 原话 “a dropped frame is a bug”——掉一帧算 bug,前端性能是它明摆着的卖点。
- 真开源:MIT,不满意就 fork。
它是怎么「秀」操作的
架构上就一句话:本机跑一个 server,桌面 / Web / 手机全是连这个 server 的客户端,所以 thread 状态天然同步。 你在哪台设备上看到的都是同一份。
Agent 接入靠 ACP(Agent Client Protocol) 这类协议——只要 Agent 支持、在你机器上登录过,t3code 就能挂上去控制。这跟 Orca 的「自带订阅 + worktree 隔离」思路一脉相承,但 t3code 明显更强调「轻、快、跨端」,Orca 更强调「一队 worker 并行编排」。定位上一个是控制面板、一个是编排台,选哪个看你到底要不要 fan-out。
代码库是 TS monorepo(pnpm workspace),还有 evals、macroscope 这些偏工程质量的东西,工程味很浓。
怎么上手
桌面直接下包,或者用包管理器:
# macOS
brew install --cask t3-code
# Windows
winget install T3Tools.T3Code
# 一行脚本装 CLI
curl -fsSL https://t3.codes/install.sh | sh
装完 t3 起 server 开 Web。想试一次不装也行:npx t3@latest。最后关键一步:装一个 Agent 并登录,比如 claude auth login 或 codex login,t3code 才有东西可管。手机走 App Store / Google Play,再按它的 remote access 文档连回电脑。
必须说的「保命」提醒
- 先有 Agent 才能用它:它不打包模型,没装没登录 Agent,它是个空壳。
- 贡献门槛不低:README 直说 review 容量有限,小修小改容易合,加功能得先在 Ideas 里开讨论过审。
- 远程访问自己评估安全:Tailscale / T3 Connect 连进来的是能执行命令的 Agent,别把这口子开到公网裸奔。
- 它跟 Orca 有重叠:都想要自带订阅 + worktree + 跨端。真要并行开一队 worker,Orca 更对口;想要轻快、纯控制面,t3code 更顺手。
学术选题推荐(按难度排序)
方向一(入门):多编码 Agent 统一控制面的抽象可行性
- 核心问题:Claude Code / Codex / Cursor 这些 Agent 能力参差,用一层统一界面(+ ACP)能不能抹平差异而不丢关键能力。
- 方法:拿同一批任务在各 Agent 上跑,记录「统一界面里哪些功能退化 / 无法表达」。
- 创新点:一套编码 Agent 能力的最小公共子集描述。
方向二(进阶):移动端异步审批对开发效率的影响
- 核心问题:离开工位后靠手机审批续跑,实际省下多少「Agent 空转时间」。
- 方法:埋点统计阻塞时长、审批响应时延,对比纯桌面工作流。
- 创新点:给「异步审批工作流」建效率模型。
方向三(进阶):把性能当 feature:AI 工具的实时前端工程
- 核心问题:流式高频更新的 Agent UI 怎么做到「掉帧即 bug」。
- 方法:实测渲染开销、长会话下的帧率与内存,分析优化手段。
- 创新点:针对高频流式 Agent 输出的渲染优化范式。
方向四(高难度):跨 Agent 的任务交接(handoff)
- 核心问题:让 Claude 把活干净地交给 Codex 接着干,context 如何无损迁移。
- 方法:构造需跨 Agent 协作的任务,测交接后的正确率与 context 保真。
- 创新点:编码 Agent 间 context 迁移协议。
简历可以这么写
编码 Agent 开源控制面(个人项目 / 二次开发)
- 基于本地 server + 多端客户端架构,实现桌面 / Web / 移动端共享同一会话状态,支持 thread 中途切换模型与 Agent 间任务交接。
- 通过 ACP 等协议统一接入 Claude Code / Codex / Cursor 等多家 Agent,屏蔽底层差异且不转售 token,直接复用用户已登录订阅。
- 实现 per-thread git worktree 隔离与 diff 审阅、一键 commit/push/PR,打通远程访问(Tailscale / 自建 server)。
- 以「掉帧即 bug」为目标优化高频流式输出渲染,长会话下保持满帧交互。
- 技术栈:TypeScript, Electron, ACP, Git worktree, Claude Code / Codex