AgentGridAgentGrid Docs
Troubleshooting

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.

On this page