Skip to main content

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.

Enhancements

Workflow templates

Workflow templates can now be selected during trellis init or switched later with trellis workflow.
  • Init flags: --workflow, --workflow-source
  • Command: trellis workflow
  • Built-in templates: native, tdd, channel-driven-subagent-dispatch
  • Marketplace resolver: workflow-resolver.ts
  • Active file: .trellis/workflow.md

Channel worker coordination

Channel workers now expose timeout warning controls and multi-kind wait filters.
  • Wait filter: trellis channel wait --kind done,killed
  • Warning event: supervisor_warning
  • Spawn flag: trellis channel spawn --warn-before <duration>
  • Disable warning: --warn-before 0ms
  • Default warning lead time: 5m

Worker inbox core API

@mindfoldhq/trellis-core/channel now exports durable worker inbox read and watch APIs.
  • Read API: readWorkerInbox()
  • Watch API: watchWorkerInbox()
  • Error class: WorkerInboxError
  • Routing SOT: matchesInboxPolicy()
  • Generation boundary: same-id respawns do not replay old worker messages

Bug Fixes

Cursor sessionStart hook

Cursor sessionStart output now matches Cursor’s top-level context schema.
  • Output field: additional_context
  • Shared format retained: hookSpecificOutput.additionalContext
  • Removed unsupported Cursor hook: beforeSubmitPrompt
  • Removed copied Cursor file: .cursor/hooks/inject-workflow-state.py

Upgrade

npm install -g @mindfoldhq/trellis@beta
trellis update
No file migration is required.