Skip to content

Render model reasoning in terminal text mode #218

Description

@travisennis

Problem

Text mode never renders reasoning blocks; only --output-format stream-json and the persisted session .jsonl carry them. A user cannot see what the model was thinking without parsing stream-json. DeepSeek-style Responses sessions persist full reasoning text verbatim and replay it on --continue/--resume, so the content is already available.

Proposed Solution

An opt-in --show-reasoning flag that renders reasoning blocks in text mode (e.g. to stderr, or inline with the message).

Alternatives Considered

A cake session show <id> --reasoning subcommand that renders a past session's reasoning instead of a run flag.

Additional Context

Recorded in ~/.local/share/cake/DESIRES.md (2026-08-01). Session record shape: src/types/session.rs; reasoning persisted per LEARNINGS (2026-08-01).

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:cliCLI flags, output formats, and exit behaviorarea:sessionSession records, persistence, and telemetry sidecarstype:featureNew capabilities or user-visible improvements

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions