Frequently Asked Questions

Does this replace Claude Code?

No. ClaudeStory sits on top of Claude Code and gives it structured project memory, workflow state, and a dashboard. You keep using Claude Code exactly as you do now.

Do I need to switch IDEs?

No. ClaudeStory works with the Claude Code workflow you already use -in your terminal, your editor, your existing setup.

Where does the data live?

Inside your project in a .story/ directory. JSON files tracked by git. No server, no cloud storage, no account required.

Does it depend on compaction summaries?

No. ClaudeStory primes sessions from deterministic project state -structured JSON files that Claude reads directly. It doesn't rely on lossy chat summaries.

Can I use it without autonomous mode?

Yes. That's the main use case. Most people use ClaudeStory for session continuity and the dashboard. Autonomous mode is optional for when the work is well-defined.

Is it free?

Free while in beta. The CLI is available now via npm. The Mac app is coming soon.

Do I need the Mac app?

No. The CLI and /story session prime are useful on their own. The Mac app adds visual management -a kanban board, handover viewer, and real-time status.