hoangsonww/Claude-Code-Agent-Monitor / plugins/ccam-devtools/skills/transcript-grep
transcript-grep
VerifiedSearch a Claude Code session transcript for a string or regex pattern and show every matching message with surrounding context. Reads /api/sessions/:id/transcript and resolves sessions via /api/sessions?limit= from the Agent Monitor dashboard. Use when hunting for a specific message, prompt, tool call, or error inside a session's conversation.
Transcript Grep
Find where a pattern appears in a session transcript and show the matches in context.
Input
The user provides: $ARGUMENTS
Interpreted as a session reference plus a search pattern, e.g.
<session-id> "rate limit" or latest TypeError. Parsing rules:
- The session reference is the first token if it looks like an id, or the words
latest/last(most recently updated session). - The remainder is the search pattern (string or regex, quoted if it contains spaces).
- If no session is given, default to the most recent session.
Data Sources
| Endpoint | Returns |
|---|---|
GET /api/sessions?limit=N | session list to resolve latest/last and to confirm the id exists |
GET /api/sessions/:id/transcript | the ordered transcript messages (role, content, tool calls/results, timestamps) for the session |
Report Sections
1. Resolve the session
If latest/last (or no id), call GET /api/sessions?limit=1. Otherwise verify
the id with GET /api/sessions?limit=1000 (or GET /api/sessions/:id). Report
the resolved id, status, and model before searching.
2. Fetch and search
Call GET /api/sessions/:id/transcript. Walk the messages in order and match the
pattern against message text, tool_name, and tool input/output content.
Case-insensitive by default; treat the pattern as a regex if it contains regex
metacharacters, otherwise as a literal substring.
3. Matches with context
For each match show:
[#N HH:MM:SS role(:tool_name)]
… preceding line of context …
> matching line with the **pattern** emphasized
… following line of context …
Number matches sequentially. Include ±1–2 messages (or lines) of context so the match is interpretable. If a tool call matches, show the tool_name and a trimmed view of its arguments/result.
4. Summary
Report: total matches, how many distinct messages matched, the roles involved (user / assistant / tool), and the timestamp span of the matches. If there are zero matches, say so plainly and suggest a looser pattern.
Output
- Lead with the match count and session header, then the contextual snippets.
- Keep snippets trimmed — truncate long tool payloads with
…rather than dumping them. - Cite only transcript content returned by the API — never fabricate messages.
- If the dashboard is unreachable, tell the user to start it with
npm startfrom the repo root.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 470k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |