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.

Two field-reported fixes from #232: trellis update no longer downgrades the OpenCode plugin; Codex Linux sandbox EPERM during python3 probe is tolerated. No new migrations.

Bug Fixes

@opencode-ai/plugin template pin: 1.1.40^1.14.39

packages/cli/src/templates/opencode/package.json previously hardcoded 1.1.40. Users who manually upgraded @opencode-ai/plugin to 1.14.x had their .opencode/package.json overwritten on trellis update, which silently downgraded the plugin on the next bun install / pnpm install. The new caret range pulls the latest 1.x at install time, so update no longer regresses the version. After updating, run inside .opencode/:
bun install   # or pnpm/npm equivalent
to refresh the lockfile to the latest 1.x.

Codex Linux sandbox: tolerate EPERM / EACCES on python3 --version probe

requireSupportedPython in packages/cli/src/commands/init.ts previously caught all child_process.execSync failures as “Python not found”, aborting trellis init. Codex’s Linux sandbox returns EPERM from execSync even when python3 is on the host PATH — the probe was failing, not the binary.
Error codeOld behaviorNew behavior
ENOENT (and others)Throw “Python not found”Same — genuine missing command still aborts
EPERM / EACCESThrow “Python not found”Warn (yellow) + proceed; assume python3 on PATH; return “version unknown”
TRELLIS_SKIP_PYTHON_CHECK=1 env var(didn’t exist)Skip the probe entirely; return “version check skipped”

Upgrade

npm install -g @mindfoldhq/trellis@rc
trellis update