> ## 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.

# v0.5.0-rc.7

> 2026-05-06

Two field-reported fixes from [#232](https://github.com/mindfold-ai/Trellis/issues/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/`:

```bash theme={null}
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 code                            | Old behavior             | New behavior                                                                |
| ------------------------------------- | ------------------------ | --------------------------------------------------------------------------- |
| `ENOENT` (and others)                 | Throw "Python not found" | Same — genuine missing command still aborts                                 |
| `EPERM` / `EACCES`                    | Throw "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

```bash theme={null}
npm install -g @mindfoldhq/trellis@rc
trellis update
```