# Trellis Channel

Use Trellis channel for live multi-agent collaboration, spawned workers, cross-agent...

- Repository: https://github.com/mindfold-ai/Trellis (15078 stars)
- Category: Testing
- License: AGPL-3.0
- Last updated: 2026-09-29
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add mindfold-ai/Trellis --skill trellis-channel -g -a claude-code -y`
Codex: `npx skills add mindfold-ai/Trellis --skill trellis-channel -g -a codex -y`
Cursor: `npx skills add mindfold-ai/Trellis --skill trellis-channel -g -a cursor -y`
Gemini CLI: `npx skills add mindfold-ai/Trellis --skill trellis-channel -g -a gemini-cli -y`

## Description

Use Trellis channel for live multi-agent collaboration, spawned workers, cross-agent review, progress inspection, forum channels, and channel log debugging.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# trellis-channel

`trellis channel` is the local multi-agent collaboration runtime. Reach for it when agents need to talk through a durable event log, when a worker should be spawned as a peer process, when an in-flight worker needs interrupt / debugging, or when feedback should be recorded on a durable `--type forum` channel.

Typical user signals: "和 codex/claude 讨论", "brainstorm with another agent", "spawn an implement/check worker", "let agent review", "open an issue board / changelog forum", "look at this thread", "channel is stuck / no output", "progress was truncated", "how do I write that channel command".

This skill is an index. Load only the reference file for the current job, do not preload all of them.

## First Commands

```bash
trellis --version
trellis channel --help
trellis channel list --all
trellis channel list --scope global --all
```

If the user names a channel or thread, inspect it before asking for background:

```bash
trellis channel forum <board> --scope global
trellis channel thread <board> <thread> --scope global
trellis channel context list <board> --scope global --thread <thread>
```

## Route By User Intent

| User intent | Read |
|---|---|
| "和 codex/claude 讨论一下", "brainstorm with another agent" | `references/workflows.md` |
| "派一个 implement/check agent", "让 agent review", "spawn a worker" | `references/workflows.md`, then `references/workers.md` |
| "开 issue 区 / topic 群 / changelog / board", "make a forum" | `references/forum.md` |
| "看看这个 thread / linked context", "inspect a thread" | `references/forum.md` |
| "channel 卡住了 / 没输出 / progress 被截断", "worker stalled" | `references/progress-debugging.md` |
| "具体命令怎么写", "what flags does X take" | `references/command-reference.md` |

## Core Rules

The rest: https://github.com/mindfold-ai/Trellis/blob/HEAD/.agents/skills/trellis-channel/SKILL.md