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

If you only had the CLI (never installed the ClaudeStory Mac app), skip ahead to Step III.

  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@latest
$storybloq setup --client all

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

Verify the migration landed cleanly:

# Verify the cleanup + install landed
$which claudestory
# should print nothing
$which storybloq
# should print a path
$claude mcp list
# should list storybloq, not claudestory

If claudestory still appears in claude mcp list, run claude mcp remove claudestory -s user and try again. Restart Claude Code once mcp list shows only storybloq.

IV.

Install the Mac app from the App Store

Storybloq for Mac is now live on the Mac App Store. Install it the regular way.

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.