trellis-channel

Coordinate multi-agent collaboration through Trellis channel event logs, workers, and forum threads.

Updated Jun 8, 2026
One-click install
npx skills add https://github.com/SilentFlower/flower-trellis --skill trellis-channel-silentflower
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: trellis-channel
Source: https://github.com/SilentFlower/flower-trellis/tree/main/.agents/skills/trellis-channel
Command: npx skills add https://github.com/SilentFlower/flower-trellis --skill trellis-channel-silentflower

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Coordinating multiple AI agents (Claude, Codex) on shared work requires a durable communication layer: spawning peer workers, routing messages, reviewing each other's output, and debugging stalled sessions. This Skill teaches agents how to use the trellis channel CLI correctly so multi-agent collaboration happens through a persistent event log instead of ad-hoc copy-paste. ## Core Features & Use Cases - Worker orchestration: Spawn Claude or Codex workers with agent cards, inject context files and JSONL manifests, then dispatch tasks and wait on done/turn_finished system events. - Forum channels: Create durable --type forum boards for issue tracking, design feedback, and internal changelogs with threads, labels, statuses, and context entries. - Progress debugging: Diagnose stalled workers using raw event inspection, worker logs, PID sidecar files, and the OOM guard, avoiding truncated pretty output. - Use Case: A dispatcher agent spawns two parallel check reviewers (one Claude, one Codex) on a task's PRD and design docs, waits for both with --all, then records the consolidated findings as a thread on a global forum channel. ## Quick Start Ask the agent to brainstorm a design decision with a Codex peer over a Trellis channel, spawning a worker and running multiple pressure-test rounds before summarizing the result.

Frequently Asked Questions about trellis-channel

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I spawn a Claude or Codex worker agent with trellis channel?▼

Run trellis channel spawn with --provider claude or codex, optionally loading an agent card via --agent from .trellis/agents. Inject context with repeatable --file or --jsonl flags, then wake the worker with send --to and block on completion using wait --kind done.

How do I wait for a worker to finish in trellis channel?▼

Use trellis channel wait with --kind done or turn_finished, which are system events the supervisor emits automatically. Do not rely on custom tags, since there is no --tag flag and workers often write tag strings as prose instead of emitting real signals.

What is the difference between chat and forum channels in Trellis?▼

Chat channels are flat message timelines, while forum channels created with --type forum organize work into threads with titles, labels, statuses, and summaries. Forum type is immutable after creation, and forum-only flags like --thread are rejected on chat channels.

Why is my trellis channel worker alive but producing no output?▼

Check the worker log file and PID sidecars under ~/.trellis/channels, then inspect raw events with messages --raw --last 50. Common causes are provider cold starts, blocking MCP servers, hung tool subprocesses, or rate limiting.

When should I use interrupt versus kill on a trellis worker?▼

Use channel interrupt for cooperative mid-turn redirection with a replacement instruction while preserving the session. Use kill when the worker must stop immediately, then respawn with --resume using the saved session id to continue.