Troubleshooting

Skills not visible in host UI

Run: pnpm run worktree:init
This command installs dependencies, builds the workspace, and runs oat sync --scope project.

Expected for native-read skill mappings. Codex can read canonical skills without mirrored provider writes.

For interactive runs, select detected providers to enable when prompted.
For non-interactive runs, configure providers explicitly:
- oat providers set --scope project --enabled <providers> --disabled <providers>
Re-run oat sync --scope project after updating config.

Run oat instructions sync --dry-run to preview changes.
Run oat instructions sync --strategy pointer|symlink|copy to apply the expected CLAUDE.md shape.
If mismatched CLAUDE.md files should be overwritten, run oat instructions sync --force (or combine it with --strategy if needed).
If stray is reported, oat instructions sync will adopt the Claude-only file into AGENTS.md and then regenerate CLAUDE.md.
If a broken or unreadable instruction path is reported, fix the underlying file or symlink target first; sync will intentionally skip manual-repair cases instead of forcing recovery.
If a directory you expected to see is missing from the scan, confirm it is not under .git, .oat, .worktrees, or node_modules.
Re-run oat instructions validate and confirm status is ok.

Use Instruction Sync for the full strategy matrix and state model.

Run oat init tools to install/update bundled OAT tool packs.
In TTY mode, select which outdated skills to update when prompted.
In non-interactive mode, rerun the relevant pack subcommand with --force if you want to overwrite outdated installed skills.