This release makes interactive shell sessions easier to inspect after they finish and less fragile in long-running workflows. Dispatch output is easier to retrieve, quiet auto-close has clearer status, and monitor mode gives better lifecycle and diagnostic signals. Spawned sessions also handle schema noise and worktree setup errors more cleanly. The docs and prompt metadata are tighter, with Codex examples updated for the current gpt-5.5 default.
Highlights
- Dispatch sessions are easier to inspect after they finish, with retained output and clearer quiet auto-close status.
- Monitor mode is easier to use for long-running gates, with clearer lifecycle notifications and not-found diagnostics.
- Spawned sessions are less fragile when schemas include empty spawn data or worktree setup hits filesystem errors.
- Prompt metadata is smaller, and Codex examples now default to
gpt-5.5.
Full changelog
Highlights
- Dispatch sessions are easier to inspect after they finish, with retained output and clearer quiet auto-close status.
- Monitor mode is easier to use for long-running gates, with clearer lifecycle notifications and not-found diagnostics.
- Spawned sessions are less fragile when schemas include empty spawn data or worktree setup hits filesystem errors.
- Prompt metadata is smaller, and Codex examples now default to
gpt-5.5.
Changed
- Document a provider-agnostic watch-until-terminal monitor recipe for external gates.
- Shrink
interactive_shellprompt metadata and move detailed usage guidance to active-only guidelines and existing docs. Thanks to @Rianico for #41. - Update Codex workflow examples to default to
gpt-5.5while keeping Codex 5.3 as an explicit fallback.
Fixed
- Keep completed dispatch output queryable for the documented five-minute cleanup window. Thanks to @gwelinder for #43.
- Prevent stale background-widget cleanup from reusing an expired session context after
/clearor session replacement (#42, reported by @luluxiang06). - Expose dispatch quiet auto-close as
completionReason: "auto-close-quiet"and mark it as non-terminal in notifications. - Fix existing-session calls that include schema-generated empty spawn placeholders, and force PTY cleanup to SIGKILL when SIGTERM does not exit (#44, by @ZacharyQin).
- Return clearer monitor query diagnostics for unknown monitor sessions.
- Validate detector-command decisions before emitting monitor events.
- Return structured errors when spawn worktree base directories cannot be created.
- Include completion details when querying completed sessions.