| name | foundry-dx |
| description | Run Foundry DX when Claude Code or Codex compaction hooks, auto-compact blocking, handoff packets, or Foundry session recovery diagnostics are needed. |
| role | tool-workflow |
Foundry DX
Use when the user asks about Claude Code or Codex compaction hooks,
auto-compact failures, handoff packets, or Foundry session recovery diagnostics.
Use lll-account-switch for switching accounts or editing routing state.
Owner Map
- CLI package:
runners/foundry-dx/package.json.
- CLI contract and help:
runners/foundry-dx/src/foundry-dx.mjs.
- CLI tests:
runners/foundry-dx/src/foundry-dx.test.mjs.
- Account-routing truth:
$HOME/code/dotfiles/bin/lll-account-switch.
- Exact hook schema: Claude Code and Codex docs; verify current shape before
changing hook output.
Workflow
- Work from the repo root.
- Run the CLI help before changing command usage:
bun run foundry-dx -- --help.
- Run
status --repo <path> for routing, health, hooks, and handoff state.
- Run
doctor --repo <path> when health should affect the exit code.
- Run
hooks install --dry-run --force --tool both --block-auto --repo <path>
before any hook write.
- Run the same command without
--dry-run only when the user wants hook config
installed.
Safety
- Treat hook install as a local config write in the target repo.
- Preview hook writes first.
