Migration guide

ClaudeStory is now Storybloq.

Same product, same file format, new name, proper Mac App Store distribution. If you installed the old ClaudeStory DMG (v1.1.x), follow these steps before the App Store version lands. Your project data stays safe – everything lives in .story/ inside each repo.

I.

Remove the old CLI, MCP server, and skill

In your terminal. Each command is copyable on its own.

# Unregister the old MCP server
$claude mcp remove claudestory
# Uninstall the deprecated npm package
$npm uninstall -g @anthropologies/claudestory
# Remove the old /story skill directory
$rm -rf ~/.claude/skills/story

The deprecated npm package is already flagged with a migration notice, so uninstalling and installing the new one is enough.

II.

Remove the old Mac app

  1. Quit ClaudeStory (or ".story") if it's running.
  2. Open /Applications and drag the app to the Trash.
  3. Empty the Trash.

Optional deep clean. Your project data is not touched.

# Optional: wipe old app container and caches
$rm -rf ~/Library/Containers/ca.shayegh.ClaudeStory
$rm -rf "$HOME/Library/Application Support/ca.shayegh.ClaudeStory"
$rm -rf ~/Library/Caches/ca.shayegh.ClaudeStory
III.

Install the new CLI and skill

$npm install -g @storybloq/storybloq
$storybloq setup-skill

That registers the new MCP server as storybloq, installs the /story skill, and configures the PreCompact hook. Your existing .story/ directories keep working unchanged.

IV.

Install the Mac app from the App Store

Storybloq for Mac is submitted and pending review. The moment it goes live, the Mac page will carry a direct App Store link.

Your project data is safe

Everything Storybloq tracks – tickets, issues, handovers, roadmap phases – lives inside .story/ at the root of each repo, committed to git. Uninstalling the old CLI and Mac app touches none of that. When you reinstall, every project picks up where it left off.

Why the rename?

The rename gave us the org Storybloq, the domain storybloq.com, and a clean break for the App Store submission. The open-source CLI, MCP server, and review lenses are still free. Your data is still yours.

Trouble?

Open an issue on GitHub or reach out on Slack.