Get History

---
description: Use when running on Claude Code and you need to examine past conversation, session logs, or raw chat history.
allowed-tools: [Bash]
---

Resolve the installed `get-history` at `${CAT_PLUGIN_ROOT}/client/bin/get-history`. Pass the
session ID whose history you need as its first argument. Without `--agent`, the launcher selects that session's main
transcript. With `--agent <agent-id>`, it selects that subagent's transcript within the requested session. If the
launcher does not exist, report that exact path before applying the shared source-checkout fallback. Do not derive or
select a transcript path in Bash.

For example:

```bash
/absolute/path/get-history "$CLAUDE_CODE_SESSION_ID" analyze
/absolute/path/get-history "$CLAUDE_CODE_SESSION_ID" summary --since "2026-08-18T10:00:00Z" --type "message" --limit 50
/absolute/path/get-history "$CLAUDE_CODE_SESSION_ID" --agent "agent-123" search "keyword" --context 2
/absolute/path/get-history "$CLAUDE_CODE_SESSION_ID" errors
/absolute/path/get-history "$CLAUDE_CODE_SESSION_ID" file-history "config.json"
```

# Shared First Use

## Design Goals

- Ensure an agent reads and follows a selected skill's complete instructions once in each conversation context.

## Guidance

If you have not already read this skill's `first-use.md` in the current
conversation context, read it now and follow it exactly. Otherwise, reuse its guidance.
Read `first-use.md` again after the context resets or is compacted.