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

> 2026-04-15

After 11 betas and 2 RCs, Trellis v0.4.0 stable is released!

## Monorepo-native support

`trellis init` now detects monorepos and creates **per-package** spec directories — every package gets its own coding conventions and tasks. To keep the command matrix from exploding alongside package count, the type-specific `before-backend-dev` / `before-frontend-dev` / `check-backend` / `check-frontend` are merged into single `before-dev` / `check` commands across 9 platforms.

## More platforms

* **GitHub Copilot** — `--copilot`
* **Windsurf** — `--windsurf`
* **Qoder** — `--qoder`
* **Factory Droid** — `--droid`

Enable multiple platforms in one go:

```bash theme={null}
trellis init --codex --gemini --copilot -u your-name
```

## Codex now fully supported

* **Codex SessionStart hook is enabled.** Codex users get the same auto-injection as Claude Code users — no need to manually invoke `/start` anymore. Task state, workflow, and guidelines are injected at session start.
* **Sub-agent definitions.** `.codex/agents/` now ships TOML-format `implement` / `research` / `check` agents, semantically aligned with Claude Code's `Agent` tool.
* **Shared skills layer.** Codex writes to `.agents/skills/` (the [agentskills.io](https://agentskills.io) standard directory). The same output is read automatically by Cursor, Gemini CLI, GitHub Copilot, Amp, and Kimi Code — one Codex checkbox covers a wide range of tools.

## Other improvements

* **Custom spec template registry.** `trellis init -r <source>` pulls spec templates from a custom git repository (GitHub / GitLab / Bitbucket, including self-hosted GitLab via HTTPS or SSH) instead of the default marketplace. Teams can host their own coding conventions on internal git servers.
* **Re-init fast path.** `trellis init --codex` adds Codex to an existing project; bare `trellis init` shows an interactive menu.
* **Branch awareness.** Sessions and journals carry git branch context, so parallel branches don't get tangled.
* **Claude Code statusline integration.**
* **Multi-agent pipeline.** Supports worktree submodules and PR state tracking.

## Notable fixes

* **SessionStart payload size fix.** Reduced from \~29 KB to \~7 KB, fixing a major silent bug where Claude Code was truncating task state on most projects.
* **Windows.** Statusline GBK encoding crash (thanks @xiangagou163) and `{{PYTHON_CMD}}` placeholder resolution in Codex `hooks.json`.

**Other fixes (selected)**

* fix(update): allow rename migrations to target protected paths + warn on config parse failure
* fix(update): parse name from `.developer` when creating migration task
* fix(hooks): normalize `.current-task` path refs across platforms (#130)
* fix(hooks): correct `SubagentStop` event field names in ralph-loop (#152)
* fix(opencode): make dispatch wait for child tasks (#147)
* fix(init): strip npm scope prefix from monorepo package directory names
* fix(init): rename "empty templates" to "from scratch" in template picker
* fix(scripts): preserve submodule status prefix in `start.py`

## Install & upgrade

```bash theme={null}
# Fresh install
npm install -g @mindfoldhq/trellis@latest --registry=https://registry.npmjs.org

# Upgrade (existing trellis install)
trellis update
```

Upgrading from 0.3.x automatically handles the 36 merged command-file deletions — with hash verification, **your local edits are preserved**; only files that haven't been modified are removed.

***

* Full changelog: [https://docs.trytrellis.app/changelog/v0.4.0](https://docs.trytrellis.app/changelog/v0.4.0)
* Repo: [https://github.com/mindfold-ai/Trellis](https://github.com/mindfold-ai/Trellis)
* Docs: [https://docs.trytrellis.app](https://docs.trytrellis.app)