Problem
The plugin assumes wt switch can move the user into the target worktree, but that depends on WorkTrunk shell integration being installed. Without it, users see path output and manual restart messages instead of automatic directory changes.
Proposal
- Add a dedicated docs section for
wt config shell install
- Explain the expected behavior with and without shell integration
- Add troubleshooting guidance for shells commonly used with Codex (
zsh, bash, fish)
- Cross-link this from the main README and Codex plugin reference
Why
This is one of the first sources of friction in a Codex + WorkTrunk flow, and it affects every subsequent command.
Problem
The plugin assumes
wt switchcan move the user into the target worktree, but that depends on WorkTrunk shell integration being installed. Without it, users see path output and manual restart messages instead of automatic directory changes.Proposal
wt config shell installzsh,bash,fish)Why
This is one of the first sources of friction in a Codex + WorkTrunk flow, and it affects every subsequent command.