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

> 2026-04-20

## Bug Fixes

* **Codex `trellis-check` was shipped read-only, contradicting its own contract.**

  `packages/cli/src/templates/codex/agents/trellis-check.toml` had `sandbox_mode = "read-only"` and framed itself as "Read-only Trellis reviewer focused on correctness". Every other platform's check agent has `Read, Write, Edit` tools and the description explicitly says "Reviews code changes against specs **and self-fixes issues**". `workflow.md` § Phase 2.2 is unambiguous:

  > The check agent's job:
  >
  > * Review code changes against specs
  > * Auto-fix issues it finds
  > * Run lint and typecheck to verify

  Result for Codex users: `trellis-check` would produce findings but could not touch the filesystem, forcing the main agent to manually apply every fix. This is a silent contract violation, not just a permissions issue — the workflow assumes check closes the loop.

  Fixed by:

  * `sandbox_mode = "workspace-write"` (same as `trellis-implement` and `trellis-research` on codex)
  * Rewrote `developer_instructions` to instruct self-fix directly, re-run lint/type-check until green, and emit a `Findings (fixed)` / `Findings (not fixed)` / `Verification` report — behaviorally identical to the Claude Code / Cursor check agent.

## Upgrade

```bash theme={null}
trellis update
```

Not a breaking release. `update.skip` is respected. If you haven't customized `.codex/agents/trellis-check.toml`, it auto-updates; if you have, you'll see the standard `Modified by you` confirm prompt with diff.

Install: `npm install -g @mindfoldhq/trellis@beta`