> ## 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
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.