Skip to main content
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 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 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 features.codex_hooks = true 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