List recent coding-agent sessions, newest first.

Discovers session logs under the configured log root (default ~/.claude/projects/) and returns up to limit sessions (default 20, max 200), most-recently-active first. Each entry includes the session id, repo/cwd, git branch, start/end timestamps, message count, schema-verification status, and a token/cost usage rollup (total tokens, estimated cost, cost status, and the main-vs-sidechain split). Pass repo to filter to sessions whose cwd/repo directory name contains that substring. Read-only; never writes to or modifies the underlying log files.

Return the tail of a session's transcript, oldest-first.

session accepts a full session UUID, a unique UUID prefix, or the keyword "latest". By default "latest" excludes the session currently calling this tool (so it never tails its own still-being-written log); pass include_current=True to opt in. Returns up to limit entries (default 100, max 1000) in chronological order. Each entry reports its type and timestamp; assistant entries list any tool(s) called and, for entries carrying usage, per-entry token counts and estimated cost; tool-result entries report each result's tool_use_id and whether it was an error. If session is ambiguous (a prefix matching multiple sessions) or matches no session, returns a structured {"error": ...} dict instead of raising. Read-only.

Summarize a session's tool calls: per-tool outcomes, failures, usage.

session accepts a full session UUID, a unique UUID prefix, or "latest" (resolved including the current session, since summarizing "my own" live session is a valid use case here). Returns per-tool invocation counts broken down by outcome (ok / error / pending / in_progress), overall totals, a main/sidechain split (tool calls made by subagents are included and tagged, never blended in untagged), the list of failing calls (each labeled error or rejected for permission denials), and the session's total token/cost usage. If this session is currently live (the most recently active discovered session), its trailing pending calls are labeled in_progress instead of pending. If session is ambiguous or matches no session, returns a structured {"error": ...} dict instead of raising. Read-only.