v0.9.0

coolhand-cli v0.9.0

August 2026 · npm · GitHub

What's new in v0.9.0

This release adds two new commands for reading LLM request logs directly, plus a handful of documentation and validation fixes surfaced during release prep.

New commands

coolhand fetch-log and coolhand search-logs — fetch a single LLM request log's input/output content, or search logs with flexible filters, via GET /api/v2/llm_request_logs/{id} / GET /api/v2/llm_request_logs (coolhand-node's Coolhand#getLogContent/searchLogs). Requires a private API key (coolhand login --scope private).

coolhand fetch-log <log-id> --section end --max-chars 2000
coolhand search-logs --model gpt-4o --source-api-result failed --days-back 7

fetch-log <log-id> supports --section, --max-chars, --search-query, and --include-thinking; search-logs supports --template-id, --workload-id, --system-prompt-contains, --user-prompt-contains, --model, --source-api, --source-api-result, --unmatched-only, --days-back, --include-prompts, --sort, and pagination. search-logs's response is { logs, pagination }, matching search-feedback's shape — pagination totals are a conservative lower-bound estimate until the backend exposes exact counts.

Fixed

search-optimizations --page/--per-page now actually validates its documented 1-50 range. Previously any value silently passed through despite the CLI's own help text advertising the limit.

login's --timeout-ms and logout's --json flags were already implemented but missing from the CLI's built-in help and docs — both are now documented.

Breaking changes

None. All changes are additive — new commands, previously-missing docs, and a validation fix that only rejects input the tool never actually supported.