chat_history_read
Read recent entries from chat-history JSONL files to recover context from previous sessions, such as decisions, notes, and phase markers. Supports filtering by session, number of entries, and entry type.
Instructions
Read recent entries back from the consumer project's chat-history JSONL (agents/runtime/.agent-chat-history; agents/.agent-chat-history accepted for back-compat). Use to recover context from an earlier session — decisions, notes, phase markers — at the start of a new task. Read-only. Returns the resolved file path plus a list of matching entries (newest last). Combine session, last, and entry_type to narrow the result.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| last | No | Return only the most recent N entries, after other filters apply. | |
| session | No | Filter to a single 16-char session id. | |
| entry_type | No | Filter by the `t` tag (e.g. note, decision, phase). | |
| path | No | Optional history-file path override; defaults to the standard chat-history location under the project root. |