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

> 2026-03-24

Decouple `.agents/skills/` as shared Agent Skills layer, add full `.codex/` directory support with hooks, platform-specific skills, and custom agents.

## Enhancements

* **Shared Agent Skills layer**: `.agents/skills/` is now a shared directory following the [agentskills.io](https://agentskills.io) open standard. It is no longer bound to the Codex platform — any universal agent CLI (Codex, Kimi CLI, Amp, Cline, etc.) can read these skills
* **Codex `.codex/` directory**: New platform-specific directory structure:
  * `.codex/config.toml` — project-scoped Codex config
  * `.codex/agents/` — custom Codex agents (implement, research, check)
  * `.codex/skills/` — Codex-specific skills (e.g. `parallel` with `--platform codex`)
  * `.codex/hooks/session-start.py` + `hooks.json` — SessionStart hook injecting full Trellis context (workflow, guidelines, task status)
* **Codex SessionStart hook**: Automatically injects Trellis workflow, guidelines, and task context into Codex sessions. Requires `codex_hooks = true` under `[features]` in `~/.codex/config.toml` (experimental Codex feature)
* **Branch context in sessions**: Session journal records now include git branch information (#108)

## Bug Fixes

* **iFlow CLI adapter**: Reverted incorrect `--agent` flag change from PR #112. iFlow uses `$agent_name` prefix format, not `--agent`
* **Codex agent TOML format**: Fixed to use correct fields (`name`, `description`, `developer_instructions`, `sandbox_mode`) instead of invalid `[sandbox_read_only]` + `prompt` format

## Migration

* **Automatic**: Old Codex users (`.agents/skills/` without `.codex/`) are auto-detected and upgraded on `trellis update`
* **safe-file-delete**: `.agents/skills/parallel/SKILL.md` (moved to `.codex/skills/`), old `trellis-*.toml` agent files (renamed)
* Run `trellis update` to apply all changes

## Breaking Changes

* **Platform detection**: `.agents/skills/` alone no longer detects as Codex. `.codex/` directory is required
* **configDir**: Codex `configDir` changed from `.agents/skills` to `.codex`

## Notes

* Codex hooks require `codex_hooks = true` under `[features]` in `~/.codex/config.toml`
* Codex hooks `suppressOutput` is not yet functional (Codex experimental limitation — context is still printed in TUI)
* `parallel` skill moved from shared `.agents/skills/` to Codex-specific `.codex/skills/` since it contains `--platform codex`