Skip to content

feat: v0.4.0-beta.8 — Shared Agent Skills layer + Codex .codex/ support#115

Merged
taosu0216 merged 24 commits intomainfrom
feat/v0.4.0-beta
Mar 24, 2026
Merged

feat: v0.4.0-beta.8 — Shared Agent Skills layer + Codex .codex/ support#115
taosu0216 merged 24 commits intomainfrom
feat/v0.4.0-beta

Conversation

@taosu0216
Copy link
Copy Markdown
Contributor

Summary

  • Decouple .agents/skills/ from Codex platform into a shared Agent Skills layer (agentskills.io open standard)
  • Add full .codex/ directory support: config, custom agents, platform-specific skills, SessionStart hooks
  • Auto-upgrade legacy Codex installations on trellis update
  • Fix iFlow CLI adapter regression from PR feat(codex): add latest codex support #112

Changes

Architecture

  • .agents/skills/ is now a shared layer used by 8+ agent CLIs (Codex, Kimi CLI, Amp, Cline, etc.)
  • .codex/ is the Codex-specific directory: config.toml, agents/*.toml, skills/, hooks/
  • configDir changed from .agents/skills to .codex
  • extraManagedPaths replaced with supportsAgentSkills flag
  • Platform detection uses .codex/ only — .agents/skills/ alone does NOT detect as codex

Codex Hooks

  • SessionStart hook injects full Trellis context (workflow, guidelines, task status)
  • Requires features.codex_hooks = true in ~/.codex/config.toml (Codex experimental feature)

Migration

Fixes

  • iFlow --agent regression reverted (PR feat(codex): add latest codex support #112)
  • Agent TOML format corrected (name + description + developer_instructions)
  • Agent naming aligned with convention (implement, research, check)

Test plan

  • 516 tests pass (26 files)
  • lint + typecheck clean
  • Python template copies identical to live scripts
  • 3 rounds of Codex cross-review, all findings addressed
  • Codex SessionStart hook tested and verified working
  • trellis init --codex creates all expected directories
  • collectPlatformTemplates tracks all .codex/ files
  • Migration manifest with safe-file-delete entries

taosu and others added 24 commits March 22, 2026 10:19
CodeBuddy (Tencent) uses .codebuddy/commands/trellis/<name>.md structure,
supporting nested directory namespacing (e.g. /trellis:start).
Includes type registry, configurator, 12 command templates, CLI flag,
and Python cli_adapter integration.
New codebuddy.test.ts, plus updates to extract, platforms, init
integration, and regression tests for full platform coverage.
Add type: ignore[import-not-found] to dynamic imports from common.*
that are resolved at runtime via sys.path. Prevents IDE false positives.
* feat(cli): add branch context to .trellis session and journal records (#106) (#108)

* feat(codex): add latest codex support

---------

Co-authored-by: Lemonadeccc <82374719+Lemonadeccc@users.noreply.github.com>
Co-authored-by: RsBin <3029898592@qq.com>
Co-authored-by: taosu <116145501+taosu0216@users.noreply.github.com>
- Add PR #112 post-merge cleanup items (iFlow revert, workspace cleanup)
- Configure implement/check/debug context files
Architecture:
- Change codex configDir from ".agents/skills" to ".codex"
- Replace extraManagedPaths with supportsAgentSkills flag
- .agents/skills/ is now a shared layer (agentskills.io standard)
- Platform detection uses .codex/ only, not .agents/skills/

Codex platform (.codex/):
- .codex/config.toml — project config
- .codex/agents/{implement,research,check}.toml — custom agents
- .codex/skills/parallel/ — Codex-specific skills (--platform codex)
- .codex/hooks/session-start.py + hooks.json — SessionStart hook

Python CLI adapter:
- config_dir_name: codex → ".codex"
- detect_platform: .codex/ → codex (not .agents/skills/)
- New requires_agent_definition_file property (false for codex)
- supports_cli_agents: added codex
- get_agent_path: returns .toml for codex

Migration (0.4.0-beta.8):
- Legacy Codex auto-upgrade via template-hashes detection
- safe-file-delete for .agents/skills/parallel/ and trellis-* agents

Cleanup:
- Fix iFlow --agent regression from PR #112
- Fix agent TOML format (name + description + developer_instructions)
- Remove workspace/task artifacts from PR #112
- Remove unused test/scripts/ Python tests
@taosu0216 taosu0216 merged commit f8471f9 into main Mar 24, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants