How do I install the Fireworks Sessions Saver skill?

Run npx skillmds@latest add yizhiyanhua-ai/fireworks-sessions-saver in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Fireworks Sessions Saver safe to use?

SkillMD's automated safety review verdict for this skill is WARNING. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Fireworks Sessions Saver?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Fireworks Sessions Saver free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Fireworks Sessions Saver?

yizhiyanhua-ai (@yizhiyanhua-ai) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Fireworks Sessions Saver by yizhiyanhua-ai

Name: Fireworks Sessions Saver
Author: yizhiyanhua-ai

Fireworks Sessions Saver

Session state persistence and recovery for Claude Code, with manual Codex checkpoint/restore workflows. TRIGGER when user asks about session persistence, context recovery, save progress, restore session, checkpoint, crash recovery, session dashboard, or wants to install fireworks-sessions-saver.

File contents

fireworks-sessions-saver

Never lose your coding session context again. Auto-persists and restores session state for Claude Code, with manual Codex flows available today.

What It Does

Network timeouts, crashes, and accidental window closures kill your session context. fireworks-sessions-saver automatically tracks what you're working on and makes it instantly recoverable.

Auto-tracking — heartbeat hook updates last_active after every file write or command
Rich checkpoints — capture task, decisions, files, and open questions on demand
One-keystroke restore — recover full context in a new session in seconds
Multi-project dashboard — see all active sessions across directories
Checkpoint diff — compare what changed between saves

Installation

Quick Install

In Claude Code or Codex, say:

"Help me install fireworks-sessions-saver from https://github.com/yizhiyanhua-ai/fireworks-sessions-saver"

Or run:

curl -fsSL https://raw.githubusercontent.com/yizhiyanhua-ai/fireworks-sessions-saver/main/install.sh | bash

npx skills Install

npx skills add yizhiyanhua-ai/fireworks-sessions-saver -g

How It Works

In Claude Code, a single PostToolUse hook fires heartbeat.py asynchronously after every Write, Edit, or Bash call — updating last_active and tracking modified files. In Codex, use the same checkpoint/restore scripts explicitly because there is no hook system yet.

Component	Purpose
`heartbeat.py`	Lightweight async hook — tracks activity after tool calls
`save_session.py`	Create rich checkpoints (init / checkpoint / cleanup)
`list_sessions.py`	Scan for recoverable sessions in current directory
`restore_session.py`	Print structured context summary from archive
`dashboard.py`	View all active sessions across directories
`diff_session.py`	Compare changes between checkpoints

Storage

~/.claude/sessions/
  active_{workdir_hash}.json          ← current session (rolling 10 checkpoints)
  archive_{workdir_hash}_{ts}.json    ← archived (restored or expired after 7 days)

Only file paths are stored — never file contents.

Requirements

Python 3.9+
Claude Code CLI for auto-tracking
Codex CLI for manual checkpoint / restore flows
macOS / Linux

More Information

Full Documentation
中文文档
Report Bug

---name: fireworks-sessions-saverdescription: Session state persistence and recovery for Claude Code, with manual Codex checkpoint/restore workflows. TRIGGER when user asks about session persistence, context recovery, save progress, restore session, checkpoint, crash recovery, session dashboard, or wants to install fireworks-sessions-saver.---# fireworks-sessions-saverNever lose your coding session context again. Auto-persists and restores session state for Claude Code, with manual Codex flows available today.## What It DoesNetwork timeouts, crashes, and accidental window closures kill your session context. `fireworks-sessions-saver` automatically tracks what you're working on and makes it instantly recoverable.1. **Auto-tracking** — heartbeat hook updates `last_active` after every file write or command2. **Rich checkpoints** — capture task, decisions, files, and open questions on demand3. **One-keystroke restore** — recover full context in a new session in seconds4. **Multi-project dashboard** — see all active sessions across directories5. **Checkpoint diff** — compare what changed between saves## Installation### Quick InstallIn Claude Code or Codex, say:> "Help me install fireworks-sessions-saver from https://github.com/yizhiyanhua-ai/fireworks-sessions-saver"Or run:```bashcurl -fsSL https://raw.githubusercontent.com/yizhiyanhua-ai/fireworks-sessions-saver/main/install.sh | bash```### npx skills Install```bashnpx skills add yizhiyanhua-ai/fireworks-sessions-saver -g```## How It WorksIn Claude Code, a single `PostToolUse` hook fires `heartbeat.py` asynchronously after every `Write`, `Edit`, or `Bash` call — updating `last_active` and tracking modified files. In Codex, use the same checkpoint/restore scripts explicitly because there is no hook system yet.| Component | Purpose ||-----------|---------|| `heartbeat.py` | Lightweight async hook — tracks activity after tool calls || `save_session.py` | Create rich checkpoints (init / checkpoint / cleanup) || `list_sessions.py` | Scan for recoverable sessions in current directory || `restore_session.py` | Print structured context summary from archive || `dashboard.py` | View all active sessions across directories || `diff_session.py` | Compare changes between checkpoints |### Storage```~/.claude/sessions/ active_{workdir_hash}.json ← current session (rolling 10 checkpoints) archive_{workdir_hash}_{ts}.json ← archived (restored or expired after 7 days)```Only file **paths** are stored — never file contents.## Requirements- Python 3.9+- Claude Code CLI for auto-tracking- Codex CLI for manual checkpoint / restore flows- macOS / Linux## More Information- [Full Documentation](README.md)- [中文文档](README.zh-CN.md)- [Report Bug](https://github.com/yizhiyanhua-ai/fireworks-sessions-saver/issues)

Frequently asked questions