tta-lab/ttal-cli
GitHub: tta-lab/ttal-cli
为多仓库团队设计的 Agent 编排 CLI,通过 Telegram 管理跨仓库任务路由、并行工作者生成和自动化 PR 审查。
Stars: 19 | Forks: 2
# TTal
多仓库团队的 Agent 运维。一个二进制文件。CLI 原生。
大多数 Agent 工具假设一个仓库、一个会话、一个任务。真实项目涉及多个仓库、多种语言、多个部署目标。TTal 协调所有这些环节的 Agent — 路由任务、生成并行工作者、推送 PR — 而你可以通过 Telegram 管理一切。
```
task → research → design → implement → review → merge → cleanup
```

## 功能特性
- **将任务路由到正确的 Agent** — 研究者调查、设计者规划、工作者实现
- **在隔离的 git worktree 中生成工作者** — 跨仓库并行执行,零冲突
- **通过自动审查推送 PR** — 针对安全、测试、类型、边缘情况的专门审查者
- **通过 Telegram 管理** — 批准、合并、重定向,全部通过手机完成
- **一个命令驱动一切** — `ttal go` 推进任何任务通过其流程
```
# 创建任务
ttal task add --project myapp "Add JWT authentication to the API"
# 一个命令驱动所有转换
ttal go abc12345
# Pipeline 路由: research → design → implement → review → merge
# 您在 Telegram 上审核判定,批准,完成
```
## 多仓库,非单体仓库
多仓库协调是一个[已知痛点](https://github.com/anthropics/claude-code/issues/23627) — Claude Code 假设每个仓库一个会话,并且没有原生方式跨仓库规划、在会话之间共享上下文或协调分支。
TTal 通过项目注册表和协调层解决此问题:
```
# ~/.config/ttal/projects.toml
[ttal]
name = "TTal Core"
path = "/code/ttal-cli"
[organon]
name = "Organon"
path = "/code/organon"
[temenos]
name = "Temenos"
path = "/code/temenos"
```
注册一次你的项目。TTal 处理其余事项:
- **跨仓库上下文** — `ei ask --project organon "src 如何处理 markdown?"` 在任何项目中生成一个沙盒化 Agent。研究而不污染你的主会话。
- **会话分叉** — 在一个会话中头脑风暴一个功能,将其分叉到项目特定的规划会话中。每个分叉携带完整对话 — 每个决定、每个"实际上,我们不这样做" — 零上下文丢失。
- **跨仓库的并行工作者** — 涉及三个仓库的功能获得三个工作者,每个都在自己的 git worktree 中,每个都沙盒化到他们的项目。他们看不到彼此,也不会相互干扰。
- **CI 集成** — 工作订阅检查状态。当 CI 失败时,守护进程直接将日志传送到工作者的会话。他们读取它、修复它、再次推送。无需人工介入 lint 和测试失败。
一个跨仓库功能涉及 TTal、temenos 和 organon,获得三个并行工作者、三个 PR、三个审查周期 — 全部通过一个流程协调。
## 工作原理
两个平面,借用网络学的控制/数据平面分离:
**管理平面** — 持有全局视角的持久化 Agent。他们知道你和他们设计了哪些功能,哪些任务被阻塞了,昨天发了什么。管理者从不接触代码。
**工作平面** — 实现任务的临时会话。每个都有自己独立的 git worktree、沙盒化环境和 tmux 会话。启动、完成工作、合并、清理。工作者从不需要担心全局。
**消息桥** — 人类 ↔ Agent 通过 Telegram。Agent ↔ Agent 通过 `ttal send`。CI 状态、PR 审查、任务更新 — 全部通过单一守护进程路由。你像在群聊中与同事一样与你的 Agent 交流。
```
┌─────────────────────────────────────────┐
│ TTal orchestration layer │
│ tasks, workers, pipeline │
├─────────────────────────────────────────┤
│ organon instruments │
│ src, web (structure-aware)│
├─────────────────────────────────────────┤
│ logos reasoning engine │
│ bash-only agent loop │
│ any LLM, no tool schemas │
├─────────────────────────────────────────┤
│ CC sandbox the sacred boundary │
│ seatbelt / bwrap │
│ OS-native, no containers │
└─────────────────────────────────────────┘
```
每一层做一件事。**TTal** 编排。[**organon**](
标签:AI代理, Claude Code, DevOps工具, EVTX分析, Git Worktree, Git工具, PR自动化, Telegram机器人, 代码审查, 任务协调, 团队协作, 多仓库管理, 多代理系统, 工作流自动化, 开源框架, 持续集成, 日志审计, 自动化管道, 软件开发, 项目协作