EntityProcess · christso · Jun 20, 2026 · Jun 20, 2026 · Jun 20, 2026
diff --git a/README.md b/README.md
@@ -123,11 +123,18 @@ my-plugin/
 │       └── SKILL.md
 ├── agents/          # Agent definitions
 ├── commands/        # Slash commands (Claude, OpenCode)
-├── hooks/           # Lifecycle hooks (Claude, Factory, Copilot)
+├── hooks/           # Lifecycle hooks (Claude, Factory, Copilot, Codex)
+├── .codex-plugin/   # Codex plugin manifest and explicit hook paths
 ├── .github/         # Copilot/VSCode overrides
 └── .mcp.json        # MCP server configs
 ```
 
+For Codex project sync, AllAgents copies skills into `.codex/skills/`, merges
+plugin hooks into `.codex/hooks.json`, and preserves user-owned hooks already in
+that file. Codex plugins can declare hooks in `.codex-plugin/plugin.json` with a
+`hooks` path, path array, inline object, or inline object array; otherwise
+AllAgents falls back to `hooks/hooks.json`.
+
 ## Documentation
 
 Full documentation at [allagents.dev](https://allagents.dev):

diff --git a/examples/workspaces/codex-plugin-stack/.allagents/workspace.yaml b/examples/workspaces/codex-plugin-stack/.allagents/workspace.yaml
@@ -0,0 +1,37 @@
+version: 2
+
+# Example: Project-scoped Codex plugin stack
+#
+# This workspace demonstrates installing a Codex-focused agent workflow stack
+# from a single declarative workspace file. AllAgents syncs these plugins into
+# project-scoped Codex files, so users do not need to run separate global
+# Codex plugin install commands on each machine.
+#
+# What gets generated:
+# - .codex/skills/       Skills from workmux, agent-tui, Beads, and Compound Engineering
+# - .codex/hooks.json   Beads hooks, merged with any existing user-owned hooks
+#
+# Requirements for using every synced skill/hook:
+# - agent-tui on PATH for the agent-tui skills
+# - bd on PATH for Beads workflows/hooks
+
+repositories: []
+
+plugins:
+  # Worktree/tmux workflow skills.
+  - https://github.com/raine/workmux/
+
+  # Beads project-management skills and Codex hooks.
+  - https://github.com/gastownhall/beads/tree/main/plugins/beads
+
+  # Compound Engineering skills. This is project-scoped skill sync; it does not
+  # require `bunx @every-env/compound-plugin install compound-engineering --to codex`.
+  - https://github.com/EveryInc/compound-engineering-plugin/tree/main/plugins/compound-engineering
+
+  # Agent TUI skills. The `agent-tui` binary is still installed separately.
+  - https://github.com/pproenca/agent-tui/tree/master/skills
+
+clients:
+  - codex
+
+syncMode: copy
diff --git a/examples/workspaces/codex-plugin-stack/README.md b/examples/workspaces/codex-plugin-stack/README.md
@@ -0,0 +1,49 @@
+# Codex Plugin Stack Example
+
+A copy-and-run workspace for installing a project-scoped Codex agent workflow
+stack with AllAgents.
+
+It includes:
+
+- `workmux` for worktree/tmux workflow skills
+- `agent-tui` skills for controlling interactive terminal sessions
+- `beads` skills and Codex hooks
+- `compound-engineering` skills without requiring the global Codex plugin install
+
+## Running It
+
+Scaffold a fresh copy anywhere:
+
+```bash
+allagents workspace init ./codex-plugin-stack-demo \
+  --from EntityProcess/allagents/examples/workspaces/codex-plugin-stack
+cd ./codex-plugin-stack-demo
+```
+
+Or run it in-place from this repository checkout:
+
+```bash
+cd examples/workspaces/codex-plugin-stack
+allagents update
+```
+
+After sync, inspect:
+
+```bash
+find .codex/skills -maxdepth 2 -name SKILL.md
+cat .codex/hooks.json
+```
+
+## Notes
+
+AllAgents syncs project-local Codex skills and hooks. It does not write Codex's
+global plugin registry, so the Compound Engineering command below is not needed
+for this project-scoped setup:
+
+```bash
+bunx @every-env/compound-plugin install compound-engineering --to codex
+```
+
+Runtime binaries are still separate from plugin artifact sync. Install
+`agent-tui` before using the agent-tui skills, and install `bd` before relying
+on Beads commands or hooks.