Output System Architecture

Shell Integration

Worktrunk uses split file-based directive passing for shell integration:

1. Shell wrapper creates two temp files via mktemp (cd and exec)
2. Shell wrapper sets WORKTRUNK_DIRECTIVE_CD_FILE and WORKTRUNK_DIRECTIVE_EXEC_FILE
3. wt writes a raw path to the CD file; shell commands to the EXEC file (for --execute)
4. Shell wrapper reads the CD file with cd -- "$(< file)" (no shell parsing)
5. Shell wrapper sources the EXEC file if non-empty

When neither directive env var is set (direct binary call), commands execute directly and shell integration hints are shown.

Output Functions