ClaudeStory CLI

Session memory for Claude Code

The claudestory CLI provides structured access to your .story/ project state. It installs a /story skill for Claude Code, registers an MCP server with 30 tools, and configures automatic snapshots.

Install

npm install -g @anthropologies/claudestory

Then run: claudestory setup-skill

Install NowGet the Mac App

/story

What /story does

Run /story in Claude Code and it:

  1. 1Loads project status -tickets, issues, phases, blockers
  2. 2Shows what changed since last snapshot
  3. 3Reads the last 3 session handovers for continuity
  4. 4Loads development rules and lessons learned
  5. 5Suggests the next ticket to work on

File convention

The .story/ directory

config.jsonProject config (name, type, language)
roadmap.jsonPhase ordering and metadata
tickets/One JSON file per work item (T-001.json, T-002.json)
issues/One JSON file per bug or gap (ISS-001.json)
notes/Brainstorming and ideas (N-001.json)
handovers/Session continuity documents (markdown)
snapshots/State snapshots for session diffs (gitignored)
MCP

30 MCP Tools

20 read tools and 10 write tools that Claude Code calls directly. Status, tickets, issues, handovers, phases, notes, lessons, snapshots, recaps, recommendations, and more.