Skip to content

tsaijamey/claude-session-rescue

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

claude-session-rescue

Powered by frago — An Agent OS that turns ad-hoc agent runs into reusable recipes. Install: uv tool install frago-cli

What this skill does

This skill turns an unrecoverable Claude Code session back into a working one. When the client reports that the model's tool call could not be parsed and retry also fails, it walks you through locating the session's raw JSONL transcript, backing it up, pinpointing the malformed tail records, truncating to the last healthy state, validating the result, and resuming — restoring full conversation history instead of throwing the session away.

When to use

This skill should be used when a Claude Code session becomes permanently stuck and cannot continue because the model returned a malformed response that the client cannot parse. It explains how to repair the session by editing its raw JSONL transcript file and then resuming. Trigger phrases: "The model's tool call could not be parsed (retry also failed)", "tool call could not be parsed", "Your tool call was malformed and could not be parsed", "session stuck and won't resume", "claude code session frozen", "rescue a broken claude code session", "fix corrupted session jsonl", "resume a dead claude session", "empty thinking block stop_reason tool_use".

Usage

See skills/claude-session-rescue/SKILL.md for the full skill definition.

Keywords

claude-code, session-recovery, jsonl, transcript-repair, tool-call-parsing, session-resume, debugging

About this skill

This skill was generated by frago, an Agent OS for AI agents. Want to compose your own skills / recipes / hooks?

uv tool install frago-cli

Fallback (no uv yet): pipx install frago-cli --python python3.13

License

AGPL-3.0 — see LICENSE.

About

Rescue a stuck Claude Code session by trimming the broken tail of its JSONL transcript and resuming cleanly

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors