Check Agent Logs

Check Agent Logs

Recover prior context by searching stored agent transcripts, reading the relevant session, and continuing from its diagnosis or decision.

Instructions

1. Choose a query and agents

Use a distinctive regex such as an error string, symbol, ticket ID, or unusual phrase. With no agent selector, the script searches all agents. Selectors compose:

python3 scripts/search_agent_logs.py "QUERY" [--claude] [--codex] [--opencode] [--pi] [--current] [--all]

• --current selects the harness running the skill.
• --all and no selector both select all four agents.
• --scope siblings is the default project scope. --scope current searches only the current checkout; --scope all searches every recorded project.
• --app NAME searches session cwd values containing NAME and overrides scope.
• --days N limits the search to recently updated sessions.

Run --help for case, snippet, cwd, and result-limit controls.

2. Read the candidate

Results are newest-first and include a stable ref, title, cwd, branch when known, timestamps, source, and snippets. Read the most likely session:

python3 scripts/search_agent_logs.py --read AGENT:SESSION_ID

Read more than one when attribution is ambiguous. Trust the printed cwd over encoded storage paths. Transcripts can contain secrets or PII; use them as context without repeating sensitive values to the user or writing them elsewhere.

3. Apply the recovered context

Continue the task using the prior diagnosis, fix, or decision. Cite the session's agent, title, and date when summarizing what was recovered.

4. Widen only as needed

If nothing matches, try an alternate query, remove --days, use --app NAME, then use --scope all. Do not make an aggregate claim when the script reports an incomplete search because an agent source was unavailable.

Examples

Find a regression without knowing the agent

User: "The KeyboardShortcut crash is back; didn't we fix it before?"

1. Run python3 scripts/search_agent_logs.py "KeyboardShortcut" --app juggler.
2. Read the best hit with --read codex:019....
3. Apply the recovered fix and cite that session.

Search only the invoking harness

User: "Find the session where this agent discussed the schema migration."

Run python3 scripts/search_agent_logs.py "schema migration" --current --scope all.

Troubleshooting

--current cannot identify the harness

Run through the repository's normal agent wrapper, which sets AGENT_HARNESS, or replace --current with an explicit agent selector.

A provider is unavailable

Use another selector only if the user intends a narrower search. An all-agent search reports missing stores as incomplete; do not treat an empty result as proof that the context never existed.

Results are noisy

Use a more distinctive query, --days N, or --app NAME. The current session may match because it contains the user's search phrase; prefer an older result whose title and snippets describe the actual prior work.