# Run History

Inspect CCAM dashboard-run history and relate live run handles to persisted Claude Code...

- Repository: https://github.com/hoangsonww/Claude-Code-Agent-Monitor (1136 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill run-history -g -a claude-code -y`
Codex: `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill run-history -g -a codex -y`
Cursor: `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill run-history -g -a cursor -y`
Gemini CLI: `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill run-history -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor`

## Description

Inspect CCAM dashboard-run history and relate live run handles to persisted Claude Code or Codex sessions. Use when finding a prior launched task, checking whether a run is still attached, reviewing start/end status, or deciding whether to resume, view, or relaunch work.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Run History

1. Run `ccam run history --limit 100`.
2. Filter by provider, working directory, model, status, and session ID.
3. For a live handle, run `ccam run get <id> --envelopes`.
4. For the persisted agent session, use `ccam session <session-id>` and the
   session transcript tools.
5. Distinguish:
   - process still live
   - process completed with usable output
   - process failed
   - history row exists but the in-memory handle was reaped
6. Recommend resume only when the native session ID is present and the selected
   provider supports that session.

Return the exact run ID, provider, session ID, working directory, model,
timestamps, lifecycle state, and the next safe action.