restore-history-from-file

Extract user and assistant text turns from JSONL conversation history files.

1|Updated Dec 3, 2025
One-click install
npx skills add https://github.com/tcdent/dotfiles --skill restore-history-from-file
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: restore-history-from-file
Source: https://github.com/tcdent/dotfiles/tree/main/agent/skills/restore-history-from-file
Command: npx skills add https://github.com/tcdent/dotfiles --skill restore-history-from-file

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, python, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill allows you to quickly resume conversational history from previously saved agent transcript files, ensuring that your conversation context is intact.

Core Features & Use Cases

  • Resume Conversational History: Restore full conversation context from JSONL files, including user and assistant text turns.
  • Filtering & Extraction: Extract only user and assistant text turns, excluding tool calls, results, and internal thinking.
  • Use Case: After a user provides a Claude Code, Codex, or other agent history JSONL file, use this skill to restore and read prior conversation turns seamlessly.

Quick Start

Use the restore-history-from-file skill with the command: 'restore-history-from-file path/to/history.jsonl'

Frequently Asked Questions about restore-history-from-file

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I restore conversational history from a JSONL file?

You can restore conversational history from a JSONL file by filtering and extracting user and assistant text turns, excluding tool calls, results, and internal thinking. This skill requires jq or Python for JSON parsing and filtering.

Can I extract only user and assistant text turns from Claude Code or Codex agent transcripts?

Yes, you can extract only user and assistant text turns from Claude Code or Codex agent transcripts. The skill filters out tool calls, results, and internal thinking to restore clean conversational context.

Do I need jq or Python to parse JSONL transcript files for context restoration?

Yes, you need either jq or Python to parse JSONL transcript files for context restoration. The skill relies on these dependencies to handle JSON parsing and filtering of user and assistant text turns.

What is the best way to resume a conversation from a previously saved agent transcript?

The best way to resume a conversation from a saved agent transcript is to use the restore-history-from-file command with the path to your history.jsonl file. This restores full conversation context by extracting text turns.

Does restoring conversation context from JSONL exclude tool calls and internal thinking?

Yes, restoring conversation context from JSONL excludes tool calls, tool results, and internal thinking. The skill specifically filters and extracts only user and assistant text turns to ensure clean conversational history.

What limitations exist when extracting conversation history from JSONL files?

A limitation when extracting conversation history from JSONL files is that tool calls, tool results, and internal thinking are excluded from the restored context. Only user and assistant text turns are preserved for administrative workflows.