storybloq
Reviewed
at commit 19245bf
New version, not yet reviewed
Caution: Its /story skill has Claude install the separate storybloq npm package globally and run its setup, which changes ~/.claude/settings.json; that package was not reviewed.
Sends data to OpenAI Codex (through your own Codex CLI), only when you pick Codex as a plan or code reviewer
Project memory for Claude Code and Codex. Storybloq stores tickets, issues, handovers, and lessons in a .story/ folder inside your repo.
0 upvotes
Log in to upvote or save- Made by
- Amir Shayegh
- Pinned commit
-
19245bf2c5ec986dec9213df5a4f9cbfaed4a31f - What we checked
-
Draws a board of your project's .story/ tickets, issues, phases and handovers in a pane beside the transcript, or as one line above the prompt, and refreshes it when those files change. The pane reads only the .story/ folder, makes no network calls and caches the fields it shows. The bundled /story skill drives the separate storybloq command-line tool and offers to install it.
Review details
Static review of the source at the pinned commit; not run. Delta review of the changes since 6b88a51; the rest carries over from the review at that commit. hooks.json loads one module, hooks/mod.ts, which registers the sidebar unless the 'sidebar' option is false. Hooks: ui.render (Pane and AbovePrompt), session.start, turn.start, turn.complete, tool.call, session.compact, ui.close, config.set, prompt.submit. Runtime calls: $.fs.exists/list/read/stat, $.store.get/set (one key, a cache of path to mtime plus displayed fields, capped at 3 MB), $.clock.every (one 25 ms timer that reads the ledger in chunks of 25 files and stats four .story directories every 2 s), $.session.usage for the context gauge and $.config.list (theme only). On session.start it walks up at most 64 parent directories looking for .story/config.json and reads only files under that .story/ folder. tool.call runs next(e) first and passes the result through unchanged; it only parses the tool name, file path and Bash command text to decide whether to rescan. prompt.submit never touches the prompt. Does nothing in -p/SDK sessions or when no ledger exists; failures are caught and logged once. No network, process spawning, eval or dynamic import in the module code. Changes in this version: only reference.md and setup-flow.md changed (wording trims; reference.md lists a new CLI command, land <sha>, described as pushing one reviewed commit after checks, which Claude would run through the storybloq CLI under the usual permission prompt, like the orchestrator push already documented; setup-flow.md adds text about a reviewer-unavailable message and a sandbox retry); no hook code changes and no new hosts, installs or allowed-tools. The skill (skills/story, about 4,000 lines of Markdown; no allowed-tools, so Claude still asks before each command) has Claude run the storybloq CLI and MCP tools, and with your permission npm install -g @storybloq/storybloq@latest and storybloq setup --client all, which per the plugin's own metadata writes CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 into ~/.claude/settings.json and registers its MCP server; the lens review fallback suggests npm install -g @storybloq/lenses and claude mcp add -s user. Review backends default to Codex plus a Claude agent, so plans and diffs go to OpenAI Codex through your Codex CLI when it is set up. It also documents an autonomous mode that suggests --dangerously-skip-permissions in trusted repositories, duet workers that inherit bypassPermissions only when the parent session runs in bypass, and an orchestrator mode that can push and deploy after confirmation. Hook modules and the diff were read in full; the skill Markdown (including the truncated SKILL.md and session-guard-fallback.md in the clone) was covered by targeted search. The npm CLI, MCP server, Codex bridge and lenses package are not in this repository and were not reviewed.
- What it uses
-
- Reads your prompts: no
- Sees tool calls: yes
- Blocks or changes tool calls: no
- Reads or writes files: yes
- Runs programs on your machine: yes
- Calls the model (uses tokens): no
- Sends data over the network: yes
- Stores data: yes
- Shows something on screen: yes
Made this mod? Add a badge to your README
Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.
[](https://modsforclaude.com/mods/storybloq/)