> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trytrellis.app/llms.txt
> Use this file to discover all available pages before exploring further.

# v0.6.0-beta.10

> 2026-05-12

加入 `trellis channel`，用于通过 shared event log 协调 worker agents 的 CLI runtime。

## Enhancements

### Trellis Channel

`trellis channel` 管理 collaboration sessions、messages、worker processes、waits、cleanup 和 one-shot runs。

| Command                                                       | 行为                                                      |
| ------------------------------------------------------------- | ------------------------------------------------------- |
| `trellis channel create <name>`                               | 创建 channel session。                                     |
| `trellis channel send <name>`                                 | 写入 message event。                                       |
| `trellis channel wait <name>`                                 | 阻塞直到匹配的 events 到达。                                      |
| `trellis channel spawn <name>`                                | 启动 Claude 或 Codex worker。                               |
| `trellis channel run [name]`                                  | 创建 ephemeral channel，运行一个 worker，打印 final answer，并清理状态。 |
| `trellis channel list` / `messages` / `kill` / `rm` / `prune` | 查看、终止、删除和清理 channel state。                              |

### Channel adapters

Claude 和 Codex worker output 会被归一化为 channel events。

| Adapter                                                | Source protocol             | Event output                           |
| ------------------------------------------------------ | --------------------------- | -------------------------------------- |
| `packages/cli/src/commands/channel/adapters/claude.ts` | Claude `stream-json`        | `message`, `progress`, `done`, `error` |
| `packages/cli/src/commands/channel/adapters/codex.ts`  | Codex `app-server` JSON-RPC | `message`, `progress`, `done`, `error` |

### Channel store

Channel events 会写入 project-scoped JSONL logs，并使用 lock 分配递增 `seq`。

| Path                                                   | Purpose                                               |
| ------------------------------------------------------ | ----------------------------------------------------- |
| `~/.trellis/channels/<project>/<channel>/events.jsonl` | Channel event stream。                                 |
| `packages/cli/src/commands/channel/store/events.ts`    | Append-only event writes 和 `seq` assignment。          |
| `packages/cli/src/commands/channel/store/paths.ts`     | Project bucket selection 和 legacy channel relocation。 |

## Internal

### Channel supervisor modules

Channel runtime internals 拆分为 adapter parsing、event storage、inbox polling、stdout pumping 和 shutdown control，统一放在 `packages/cli/src/commands/channel/`。

## Upgrade

```bash theme={null}
npm install -g @mindfoldhq/trellis@beta
trellis update
```