Common Errors
A reference of common errors you might see in AgentGrid and how to fix them.
This page collects errors that surface in a pane or a dialog, what causes them, and how to recover.
"No conversation found with session ID: <id>"
You'll see this inside a pane, often paired with auto-resume stopped after 3 attempts — click Resume to retry.
Cause. AgentGrid is trying to resume a Claude Code session — for example after you restart the app — but the underlying Claude Code session transcript no longer exists on disk. Claude Code deletes session transcripts after 30 days by default. Once a transcript is gone, AgentGrid can't resume that pane; the conversation history is no longer available to replay.
Fix. Extend how long Claude Code keeps sessions. In your Claude Code settings file at ~/.claude/settings.json, set cleanupPeriodDays to a larger retention window (in days). For example:
{
"cleanupPeriodDays": 365
}Then restart AgentGrid. New sessions will be retained for the extended period.
Sessions that were already deleted before you changed this setting cannot be recovered. cleanupPeriodDays is a global Claude Code setting and affects every Claude Code session on your machine, not just the ones started from AgentGrid.
Keep working in the meantime. If a single pane shows this error, you can start a fresh session in that space and keep going — only that pane's prior history is lost. Other panes and spaces are unaffected.
No traces in Langfuse after enabling Observability
Cause. Export is off by default, uses a different port than many Langfuse tutorials (3100 for Agent Grid’s managed install), and only applies to new agent harness sessions — not plain shells and not sessions started before you saved settings.
Fix. Confirm Settings → Observability is enabled, keys and OTLP endpoint match your Langfuse project (http://localhost:3100/api/public/otel for managed local Langfuse), Docker is running if you use local Langfuse, then spawn a new Claude session and check Langfuse again. Step-by-step: Observability with Langfuse.