If you're like me and use Claude Code daily, you may have wished for a more accessible history of your conversations to version alongside your code. Claude Code is amazing but the JSONLs are gnarly.

Built a lightweight CLI wrapper that launches Claude Code and auto-saves every conversation as a markdown file in your project directory.

What it does:

• 📝 Auto-saves: every conversation to ~/.specstory/history as clean markdown files when running in interactive mode

• 🔄 Sync-conversions: directly from previous Claude Code sesisons to markdown if you want your old history specstory -s

• 🔍 File naming: uses a timestamp + first user prompt message to generate descriptive filenames from your conversation content

• 🖥️ Cross-platform: works on macOS, Linux/WSL

• 🔒 100% local: all conversation data stays on your machine (with optional analytics you can opt-out)

Installation via Homebrew

brew tap specstoryai/tap
brew update
brew install specstory

Other installation options are here in our docs.

Usage
Once installed should be low friction, you can launch via specstory instead of claude to run Claude Code. Checkout help via specstory -h for all the options.