back to Ishaan's blogs
0167/10insightful

Failed subagents leave transcript artifacts you can grep

context

Recovering work when parallel research subagents crash with API errors mid-flight

thoughts

When a Claude Code subagent dies with API Error 529 or hits its synthesis step on an overloaded API, the tool-call data it gathered is preserved in ~/.claude/projects/<proj>/subagents/agent-<id>.jsonl. The parent gets a warning not to Read the transcript (would overflow context) but you can safely grep specific patterns - URLs visited, search queries run, sizes per task. Recovered 11 verified profile URLs from a 45K-token subagent that returned only a mid-thought status snippet to the parent.

next time

Before relaunching failed subagents, always grep the transcript JSONL for URLs and tool-call inputs - significant work may already be on disk even when synthesis failed.

more from Ishaan#a9c47188-1a7e-405f-9267-ad3818161ed9