FAQ
Frequently asked questions.
If something is not here, the code is in your repo. Read it, run it, and write us back.
What is Storybloq?
Storybloq is an agentic development framework for Claude Code. It tracks tickets, issues, session handovers, and roadmap phases in a .story/ directory inside your repo, and shows them in a native Mac app.
Does this replace Claude Code?
No. Storybloq sits on top of Claude Code. You keep using Claude Code exactly as you do now. Storybloq adds structured project state and a visual dashboard so your sessions build on each other instead of starting from scratch.
How do I install it?
Run npm install -g @storybloq/storybloq, then storybloq setup-skill. That installs the CLI, registers the MCP server with Claude Code, and sets up the /story command. The Mac app is a separate download from the website.
Where does my data live?
Inside your project in a .story/ directory. Local files tracked by git. No server, no cloud storage, no account required. You can read, edit, and version everything yourself.
What is a session handover?
A session handover is a written record of what happened during a Claude Code session: what was built, what decisions were made, why those decisions were made, what is still open, and what should happen next. Git shows what changed. Handovers explain why.
How does /story work?
Type /story at the start of a Claude Code session. It loads the current project state: tickets, issues, recent handovers, and lessons learned. Claude knows what was built, what is blocked, and what to work on next. No guesswork.
Can I use it without the Mac app?
Yes. The CLI and /story session prime are useful on their own. The Mac app adds a visual layer: a kanban board, handover viewer, and real-time project status.
Can I use it without autonomous mode?
Yes. That is the main use case. Most people use Storybloq for session continuity and the dashboard. Autonomous mode is optional for when the work is well-defined and you want Claude to move through tickets on its own.
What is autonomous mode?
Autonomous mode lets Claude work through a backlog of tickets on its own: picking work, planning, reviewing the plan, implementing, reviewing the code, committing, and moving to the next ticket. Plans and code are reviewed by an independent model (Codex from OpenAI) before anything ships.
Does it work with Cursor or other AI coding tools?
Storybloq is built for Claude Code. The .story/ directory is a standard file convention that any tool can read, but the MCP server, /story skill, and autonomous mode are designed specifically for Claude Code.
Do I need to switch IDEs?
No. Storybloq works with your existing setup. Claude Code in your terminal, your editor, your workflow. Nothing changes except that your project now has structured memory.
Is it free?
Yes. The CLI and Mac app are both free.
What about privacy?
All project data stays local. The Mac app includes optional anonymous analytics and crash reporting (via Sentry and TelemetryDeck, both EU-hosted), enabled by default. You can opt out in Settings at any time. No project content is ever sent anywhere.