This project addresses the stateless nature of AI coding assistants by providing persistent, structured context across sessions. It targets developers using AI coding tools like Claude Code and Codex, enabling compounding work and reducing repetitive tasks and errors through a standardized file convention, CLI, and AI integration.

How It Works

Storybloq establishes a .story/ directory within projects to store metadata like tickets, issues, roadmap phases, and session handovers in JSON and Markdown files. A CLI tool, storybloq, allows direct management of this data. An integrated MCP server exposes 43 tools for AI assistants, enabling direct interaction without subprocesses. A Claude Code skill (/story) loads project state at the beginning of each session, providing continuity.

Quick Start & Requirements

Install the CLI globally via npm: npm install -g @storybloq/storybloq@latest

Then, set up the AI client integrations: storybloq setup --client all

Requires Node.js 20+ and an AI client like Claude Code or Codex CLI 0.130.0+. Official documentation and releases are available on storybloq.com and GitHub.

Highlighted Details

• Persistent Context: Manages project state (tickets, issues, roadmap, handovers, lessons learned) in a structured .story/ directory.
• AI Integration: Provides 43 MCP server tools for direct AI interaction and a /story skill for Claude Code to load project context.
• Autonomous Workflow: Supports an autonomous mode (/story auto T-001) to drive tickets through a defined lifecycle.
• Code Review: Integrates with @storybloq/lenses for multi-lens code review capabilities.
• Native App: A companion Mac app provides a live-updating sidebar that monitors the .story/ directory.

Maintenance & Community

The project welcomes issues and PRs, recommending opening an issue first for non-trivial changes. Related projects include @storybloq/lenses and the Storybloq Mac app. No direct links to community channels like Discord or Slack are provided in the README.

Licensing & Compatibility

Licensed under PolyForm Noncommercial 1.0.0. It is free for personal and noncommercial use. Commercial licensing requires direct contact with the maintainer at shayegh@me.com. Redistribution requires propagating the NOTICE file.

Limitations & Caveats

The noncommercial license is a significant restriction for adoption in commercial environments. The project relies on specific AI clients (Claude Code, Codex) and Node.js versions. The Mac app is described as a separate product.