NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules
Go modules, #1481 by repository stars
Latest stable
v2.15.1+incompatible
Last release 1 months ago
24 Sep 2026
Release timing varies
gaps range from 8 days to 2 months
Most releases are documented
notes for 35 of 55 stable releases
Nothing withdrawn
no release was ever pulled
1 years old
67 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
The SpecStory CLI now supports DeepSeek TUI (i.e. deepseek-tui) for sessions created from DeepSeek TUI version 0.8.39 or higher. Sessions from earlier
deepseek-tui) for sessions created from DeepSeek TUI version 0.8.39 or higher. Sessions from earlier versions may work, but are not officially supported. This provides the same support for saving to local markdown files and to the SpecStory Cloud as for Claude Code, Cursor CLI, Codex CLI, Gemini CLI and Factory's Droid CLI. Thank you to KiBlazer for the contribution.Improve markdown file naming accuracy for the Claude Code provider by filtering additional system-injected messages from slug generation.
specstory watch and specstory watch droid commands.specstory sync now generates session statistics at ./.specstory/statistics.json. This data is available for custom tooling or analysis, or you can saf
specstory sync now generates session statistics at ./.specstory/statistics.json. This data is available for custom tooling or analysis, or you can safely ignore it.specstory sync now supports an --only-stats flag that skips the full local and/or cloud sync and only generates or updates ./.specstory/statistics.json.v0.30.0+ changed how it names project directories under ~/.gemini/tmp/. Previously it used a SHA256 hash of the project's absolute path (e.g., c18385f0...). Now it uses the project folder's basename and stores the actual project path in a .project_root file inside that directory. Issue #183specstory watch.Added optional OpenTelemetry metrics for agent sessions. Enable via the --telemetry-endpoint, --telemetry-service-name, and --no-telemetry-prompts fla
--telemetry-endpoint, --telemetry-service-name, and --no-telemetry-prompts flags on run, sync, or watch, or through the telemetry configuration options. See the OpenTelemetry section of the README for more information.SpecStory CLI now supports configuration files in TOML format at user (~/.specstory/cli/config.toml) and project (./.specstory/cli/config.toml) levels
~/.specstory/cli/config.toml) and project (./.specstory/cli/config.toml) levels. See the usage guide for more details.specstory check command checks your user and project level config files for validity.--debug-dir flag and configuration to set the location of your debug output, separate from the --output-dir location.Provide activity updates to stdout while specstory watch is running.
specstory watch is running.specstory watch --json flag for easily parsable output activity updates.exec_command shell tool.New --print flag for specstory sync -s {session-ID} --print command to output the markdown to stdout rather than sync it to a file. The flag works for
--print flag for specstory sync -s {session-ID} --print command to output the markdown to stdout rather than sync it to a file. The flag works for multiple sessions with specstory sync -s {id1} -s {id2} --print.specstory run claude command, prefer the Claude Code "native install", ~/.local/bin/claude, over the npm install, ~/.claude/local/claude, when both are present.specstory run startup when logged into SpecStory Cloud but the service is unavailable.New specstory list command to list all sessions for all supported providers for the current project directory. Can also be used to list sessions for a
specstory list command to list all sessions for all supported providers for the current project directory. Can also be used to list sessions for a specific provider, e.g. specstory list claude.specstory list --json flag for easily parsable output.The Claude Code provider now gracefully handles corrupt JSON objects in JSONL session data, continuing to parse valid entries rather than failing to r
specstory sync now displays progress feedback while parsing sessions.-s flag on specstory sync now accepts multiple session IDs: specstory sync -s {id1} -s {id2}.WebFetch and WebSearch tool outputs for the Claude Code provider now include the source URL and search term in their output.WebFetch returns markdown content.Nothing published for this version
The SpecStory CLI now supports Factory's Droid CLI (i.e. droid) for sessions created from Factory Droid version 0.56.3 or higher. Sessions from earlie
droid) for sessions created from Factory Droid version 0.56.3 or higher. Sessions from earlier versions may work, but are not officially supported. This provides the same support for saving to local markdown files and to the SpecStory Cloud as for Claude Code, Cursor CLI, Codex CLI and Gemini CLI.Added a --local-time-zone flag to the sync, run, watch commands to use local timezone for file name and content timestamps rather than UTC.
--local-time-zone flag to the sync, run, watch commands to use local timezone for file name and content timestamps rather than UTC.Added a specstory watch command to watch a project directory for any coding agent activity from any supported provider and auto-save sessions to local
specstory watch command to watch a project directory for any coding agent activity from any supported provider and auto-save sessions to local markdown and/or the SpecStory Cloud../.specstory/history dir is deleted while the long running run or watch commands are still running.Nothing published for this version
Added a --only-cloud-sync flag to the sync and run commands to skip local markdown writes and only sync to the SpecStory Cloud.
--only-cloud-sync flag to the sync and run commands to skip local markdown writes and only sync to the SpecStory Cloud.Nothing published for this version
Nothing published for this version
Now that the SpecStory CLI is open sourced under the Apache 2.0 license at https://github.com/specstoryai/getspecstory/tree/main/specstory-cli it is n
v1.0.0 🎉sync or run.The SpecStory CLI is now open sourced under the Apache 2.0 license at https://github.com/specstoryai/getspecstory/tree/main/specstory-cli and contribu
AskUserQuestion tool use with the Claude Code provider.A major internal refactor was done to move markdown generation from the providers to the CLI layer, and to standardize the markdown output across all
v2.1.0 with tool types standardized as write, read, search, shell, task, generic, unknown, and with timestamps on all user and agent messages, where available.v2.1.0 files, which support a significantly enhanced web UI when sessions are viewed in the SpecStory Cloud web app.<system-reminder>...</system-reminder> content about malicious content in the generated markdown on "Read" tool results.shell_command tool.--no-usage-analytics flag was used.The SpecStory CLI now supports Google's Gemini CLI (i.e. gemini) for sessions created from Gemini CLI version 0.15.1 or higher. Sessions from earlier
gemini) for sessions created from Gemini CLI version 0.15.1 or higher. Sessions from earlier versions may work, but are not officially supported. This provides the same support for saving to local markdown files and to the SpecStory Cloud as for Claude Code, Cursor CLI and Codex CLI.The Codex CLI provider now generates SpecStory markdown v2.0.0 files, which support a significantly enhanced web UI when sessions are viewed in the Sp
apply_patch tool, which is used to apply a patch to a file.specstory run with the Claude Code provider no longer creates additional markdown files for "Warmup" messages.
specstory run with the Claude Code provider no longer creates additional markdown files for "Warmup" messages.specstory run would give SpecStory Cloud sync stats timeout count of n - 1 sessions, where n is the number of incremental syncs attempted. This has been fixed.Reduced network activity during more efficient bulk SpecStory Cloud syncs.
Introduced a SpecStory Cloud sync debounce in specstory run to reduce the number of network syncs to the SpecStory Cloud.
specstory run to reduce the number of network syncs to the SpecStory Cloud.<user_query> tags around user messages in the markdown file names and markdown content that's output from newer versions of the Cursor CLI.specstory run to match the actual number of sessions created/updated/skipped.Skip the synthetic "warmup" user message that's always present in newer Claude Code sessions to generate more unique slugs for SpecStory history markd
The SpecStory CLI now supports OpenAI's Codex CLI (i.e. codex) for sessions created from Codex CLI version 0.42.0 or higher. Sessions from earlier ver
codex) for sessions created from Codex CLI version 0.42.0 or higher. Sessions from earlier versions may work, but are not officially supported. This provides the same support for saving to local markdown files and to the SpecStory Cloud as for Claude Code and Cursor CLI.Fixed an issue where the CLI would abort when encountering JSON in a Claude Code JSONL file that was larger than 10MB issue #108 The new limit is 250M
The SpecStory CLI now supports the Cursor CLI (i.e. cursor-agent) for sessions created from Cursor CLI version 2025.09.18-7ae6800 or higher. Sessions
cursor-agent) for sessions created from Cursor CLI version 2025.09.18-7ae6800 or higher. Sessions from earlier versions may work, but are not officially supported. This provides the same support for saving to local markdown files and to the SpecStory Cloud as for Claude Code.check, run and sync commands now take an optional <agent-provider> argument to specify the provider to use for the command, e.g. specstory check claude, specstory run cursor, or specstory sync claude, if unspecified it defaults to claude for run and both providers for check and sync-s / --session flag replaces the -u / --session-uuid flag to specify a specific session ID for the sync command--command flag replaces the --claude-code-cmd flag to specify a custom command to run the agentFixed an issue where special characters in the project name were not being properly handled to find the Claude Code project directory issue #102
Search across all your AI Chat history with the SpecStory Cloud web app
specstory sync and specstory runspecstory login, logout using specstory logout--no-cloud-sync flagspecstory -v, specstory --version, specstory --help, specstory -h, and invalid flags.Skip writing markdown files for sessions that have no user messages, this is especially useful to avoid creating empty markdown files when using inter
specstory run)specstory and specstory helpspecstory sync, to include showing the progress of parsing and processing JSONL files/clear command in Claude Code was resulting in subsequent sessions that were not being written to markdown files/compact or force-compacting the history in Claude Code was resulting in subsequent sessions that were not being written to markdown filesspecstory run, specstory version, and specstory helpCreates a .specstory/.project.json file to track the project ID and name the project, in preparation for the future cloud sync feature in the CLI
.specstory/.project.json file to track the project ID and name the project, in preparation for the future cloud sync feature in the CLIlog/slogspecstory sync is run in a directory that is not an existing Claude Code project directoryspecstory check now tells you where the claude command that SpecStory will use is located--console flag for the run and sync commands to enable error/warn/info debug output to stdout, replaces the --verbose flag--debug flag for the run and sync commands to enable debug level output to --log or --console output--log flag) to .specstory/debug/debug.log filespecstory sync to show the progress of parsing JSONL files and syncing markdown filesSupport for the new "Native binary installation" of Claude Code (curl -fsSL claude.ai/install.sh | bash) which results in a ~/.local/bin/claude binary
curl -fsSL claude.ai/install.sh | bash) which results in a ~/.local/bin/claude binary--output-dir flag for the sync and run commands to specify the output directory for the markdown files and logs, issue #86--resume <session-id> flag to the run command to resume a specific session by IDrun command would result in duplicate markdown files with slightly offset filename timestamps for the interactive sessionInclude content from the agent thinking in the markdown output
thinking in the markdown output--- separator between user messages and agent messages.specstory/.history.json file to track sessionsspecstory check when Claude Code installed and accessiblespecstory check when Claude Code cannot be run--version flag was not working, only the version command was workingOne column per month.