Vibeleaderboard
← Back to Tools
Index / tool

Fireworks Sessions Saver

https://github.com/yizhiyanhua-ai/fireworks-sessions-saver
Visit github.com
Category
Developer Tools
Rank
No. 1279Tools index

Previous survey · No. 1286 ·

Pricing
Open Source
Type
TOOL
Builder
yizhiyanhua-ai
GitHub
8 stars
Date

About

Auto-persists and restores session state across Claude Code, Codex, and other coding CLI tools so you never lose context.

What it does

It keeps a local, structured work journal for coding sessions. Lightweight activity tracking records recently changed file paths, while richer checkpoints capture the current task, decisions, questions, commands, branch, and log references. Recovery presents that information as a readable summary, with dashboard and checkpoint comparison views for navigation.

Why it's ranked here

The tool solves a narrow, expensive failure mode with transparent local storage and small Python utilities. Its Claude Code integration covers tracking, startup initialization, recovery, comparison, and multi-project visibility. The verdict is mixed for Codex users because their workflow remains explicitly manual.

What's good

Session records stay readable as JSON and contain file paths rather than source contents. Checkpoints retain useful reasoning artifacts, including decisions and blockers, not merely activity timestamps. The rolling history is bounded, stale sessions are filtered, transferred archives can be removed, and the dashboard can emit formatted or raw JSON output.

Tradeoffs

Automatic tracking is specific to Claude Code. Codex requires explicit initialization, checkpoint, listing, and restoration commands. Rich checkpoint quality depends on supplied summaries and metadata because the heartbeat only updates activity and modified paths. The installer requires Claude Code even though the scripts support manual Codex use. Session data can still expose sensitive project paths and task summaries.

How to use it well

It fits macOS or Linux developers who keep long Claude Code sessions, switch among projects, or regularly lose context to interrupted terminals. Save rich checkpoints at meaningful task boundaries, then use the automatic heartbeat between them. Codex users should script the manual commands. It does not replace source control, full conversation archives, or off-machine backup.

Technical notes+

install.sh downloads the skill into ~/.claude/skills/fireworks-sessions-saver, syntax-checks six Python scripts, and patches ~/.claude/settings.json with asynchronous PostToolUse and SessionStart hooks. skill/scripts/save_session.py keys active JSON files by the first eight characters of an MD5 hash of the absolute working directory, keeps ten checkpoints, collects Git branch and recent commits, and discovers recent Claude Code or Codex logs. skill/scripts/heartbeat.py performs unlocked read-modify-write updates, caps detected Git files at ten per scan and the latest checkpoint at twenty file entries, and suppresses failures. skill/scripts/list_sessions.py filters records older than seven days; skill/scripts/restore_session.py, skill/scripts/diff_session.py, and skill/scripts/dashboard.py provide text-oriented recovery, comparison, and cross-project inspection.

Observed

License
MIT License
Primary language
Python, with a Bash installer
Runtime
Python 3.9 or newer
Install surface
Shell installer and global skill installation through npx skills
Interfaces
Claude Code hooks, manual Python CLI scripts, and a Claude Code skill
Platform support
macOS and Linux
Storage
Local JSON session files under ~/.claude/sessions; file paths are stored, not file contents
Repository structure
No test directory appears in the supplied repository tree

Read from README.md, skill/scripts/dashboard.py, skill/scripts/heartbeat.py, skill/scripts/diff_session.py, skill/scripts/save_session.py, skill/scripts/list_sessions.py, skill/scripts/restore_session.py, LICENSE, SKILL.md, install.sh, SECURITY.md, README.zh-CN.md, CODE_OF_CONDUCT.md, skill/SKILL.md, article/article.md.

What it can do

  • Auto-save session state for Claude Code

    Active Claude Code session → Persisted session data

  • Auto-save session state for Codex

    Active Codex session → Persisted session data

  • Auto-save session state for coding CLI tools

    Active CLI tool sessions → Persisted session data

  • Restore Claude Code session context

    Previously saved session data → Restored Claude Code session with full context

  • Restore Codex session context

    Previously saved session data → Restored Codex session with full context

  • Restore CLI tool session context

    Previously saved session data → Restored CLI tool session with full context

Tags

claude-codecodexsessionsclipersistence

Tech Stack

PythonShell

Comments (0)

No comments yet

Editorially curated, with community endorsements as a secondary signal. Corrections welcome.