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.
Adds trellis upgrade and carries stable-line context fixes into the 0.6 beta track.
Enhancements
Trellis Upgrade
trellis upgrade installs the npm channel that matches the current CLI version.
| Command | Behavior |
|---|
trellis upgrade | Installs @mindfoldhq/trellis@latest, @beta, or @rc by channel. |
trellis upgrade --tag <tag> | Installs an explicit dist-tag or version. |
trellis upgrade --dry-run | Prints the npm command without installing. |
trellis upgrade instead of raw npm install -g
commands.
Brainstorm Templates
Bundled brainstorm instructions are shorter and match the beta.8 planning
artifact flow.
| Template | Change |
|---|
packages/cli/src/templates/codex/skills/brainstorm/SKILL.md | Uses the shorter brainstorm routing model. |
packages/cli/src/templates/common/skills/brainstorm.md | Uses the same shared planning contract. |
packages/cli/src/templates/copilot/prompts/brainstorm.prompt.md | Mirrors the shorter prompt text. |
Bug Fixes
Upgrade Execution
The upgrade command validates tag/version input, avoids shell interpolation on
POSIX, uses cmd.exe /d /s /c on Windows, and prints npm/PATH troubleshooting
when installation fails.
OpenCode Context Prefix
OpenCode now picks the TRELLIS_CONTEXT_ID prefix for the shell dialect that
will parse the command.
| Environment | Prefix format |
|---|
| Windows PowerShell | $env:TRELLIS_CONTEXT_ID = ... |
| Windows Git Bash/MSYS/Cygwin | export TRELLIS_CONTEXT_ID=... |
Existing env prefix | env TRELLIS_CONTEXT_ID=... |
Session Context
Non-Git Trellis roots no longer report fake clean Git state. Session context now
states that the root is not a Git repository and scans bounded child repositories
for unconfigured polyrepo layouts.
OpenCode Sub-Agent Context
Trellis implement/check/research child sessions skip duplicate workflow-state
injection and resolve the active task from session runtime, an Active task:
prompt hint, or a single-session fallback.
jsonl entries -> prd.md -> design.md if present -> implement.md if present
Hook Timeouts And Copilot
Hook defaults now allow 30s for SessionStart and 15s for per-prompt workflow
injection across hook-based platforms. Copilot SessionStart output no longer
emits the stale systemMessage; it keeps hookSpecificOutput.additionalContext.
Internal
Manifest Continuity
The beta line restores 0.5.13.json so future beta manifest checks include the
stable 0.5.13 release.
Upgrade
npm install -g @mindfoldhq/trellis@beta
trellis update
