v0.5.0

v0.5.0 2025-07-14

✏️ Markdown Enhancements

• Include content from the agent thinking in the markdown output
• Improved markdown formatting for agent tool use for "MultiEdit"
• Indicate if tool use was successful or not in the markdown output
• Fix the --- separator between user messages and agent messages

⚙️ Improvements

• No longer use a .specstory/.history.json file to track sessions

🔧 CLI Configuration & Commands

• More helpful output from specstory check when Claude Code installed and accessible
• Helpful output from specstory check when Claude Code cannot be run

📦 Distribution & Build

• Improved the version update check to include the new version number in the output

🐛 Bug Fixes

• --version flag was not working, only the version command was working
• Fixed duplicate output of error messages

v0.4.0 2025-07-09

✏️ Markdown Enhancements

• Improved markdown formatting for agent tools use for "Bash", "Write", "Read" and "Grep"
• Change attribution of chats from Claude Code to "Agent" rather than "Assistant"
• Include the model and model version in the "Agent" attribution
• Don't include the isMeta/true user messages "Caveat: The messages below were generated by the user.." in the markdown file
• Good markdown formatting for / commands entered by the user in Claude Code
• Better markdown file naming by skipping isMeta and / commands from the user message for naming the filename
• Don't include the <system-reminder>...</system-reminder> about malicious content in the generated markdown on "Read" tool results

🔧 CLI Configuration & Commands

• Moved from a flag based CLI to one based on commands
  • Commands for: run, sync, check, help, version
  • Flags for: --log, --verbose, --silent, --no-version-check, --no-usage-analytics
• Command specific help, e.g. specstory help sync
• Fully styled help via Fang
• Improved help text and example usage

🐛 Bug Fixes

• Remove the proactive check for Claude Code in the PATH, as this no longer works with Anthropic's self-managed install approach (~/.claude/local/claude with a claude alias)
• Instead of defaulting to claude when no Claude Code Command (-c) is provided, first check for the presence of ~/.claude/local/claude and use that as the default if present, to work with Anthropic's self-managed install approach
• If ~ is used in the Claude Code Command (-c) it was being treated literally, rather than expanded

v0.3.0 2025-07-03

✏️ Markdown Enhancements

• Generate markdown files with formatted todos including priority indicators (🔥/🌡️/❄️) and completion status ([ ], [⚡], [X]) for the TodoWrite tool

⚙️ Improvements

• Added progress and summary output to runs of the -s sync markdown command
• Add result output to runs of the -u single session command

🔧 CLI Configuration & Commands

• Added --silent mode to suppress output during single session (-u) or sync (-s)

🐛 Bug Fixes

• Flag validation - Using --silent and -v flags together returns an error

v0.2.0 2025-07-01

✏️ Markdown Enhancements

• Now when the user message to Claude Code consists of just an image, or includes one or more images, specstory will include this fact in the generated markdown file.
• Now when Claude Code breaks up user messages into multiple parts, specstory includes all the parts in the generated markdown file, not just the first part.

🐛 Bug Fixes

• Fixed an issue where specstory would not find the Claude Code ~/.claude/projects directory for the project if the project path contained the _ character.
• Fixed an issue where running with the -u flag when there was no .specstory/history directory would cause specstory to exit with an error

v0.1.0 2025-06-26

⚙️ Improvements

• Deterministic filenames - Implemented deterministic filenames for consistent builds

📦 Distribution & Build

• Automatic version checking - Check for newer versions of specstory and output a message if available
• Version check bypass - Use --no-version-check to disable version checking for current run

🔧 CLI Configuration & Commands

• Installation verification - Added --check-install command for system validation
• Logging control - New --log flag for enhanced debugging capabilities
• Flag validation - Using -s and -u flags together now properly returns an error
• Analytics control - Use --no-usage-analytics to disable analytics for current run
• Version check bypass - Use --no-version-check to disable version checking for current run

📊 Analytics

• Analytics control - Use --no-usage-analytics to disable analytics for current run
• Session tracking - Enhanced analytics integration with configurable opt-out options

🐛 Bug Fixes

• Sidechain stability - Fixed hanging issues in sidechain operations
• Exception handling - Resolved exception errors in sidechain processing
• Duplicate prevention - CLI no longer writes duplicate files
• Major stability fix - Resolved critical stability issue (the big fix)

v0.0.3 2025-06-20

📦 Distribution & Build

• Version updates - Update pinned CLI version

📊 Analytics

• Shared analytics ID - CLI now sync analytics IDs (macOS only)
• PostHog tracking - Added basic PostHog tracking of activated sessions when CLI runs in interactive mode

v0.0.2 2025-06-20

✏️ Markdown Enhancements

• Tool argument display - Show grep tool arguments in markdown output
• Tool result messages - Tool outputs now properly display as assistant responses

⚙️ Improvements

• Better error handling - No longer checks if CLI path exists, just tries to run and shows errors if they occur

📦 Distribution & Installation

• Homebrew support - Fixed Homebrew setup and artifact URLs for easier installation
• Dual archive format - CLI now distributed as both tar.gz and zip archives
• Build improvements - Added ID to archives for better build tracking

🔧 CLI Configuration & Commands

• Verbose flag - Added -v verbose flag to show informational logging only when needed
• Updated flags - Improved CLI flag handling and configuration

v0.4.0

v0.4.0 2025-07-09

✏️ Markdown Enhancements

• Improved markdown formatting for agent tools "Bash", "Write", "Read" and "Grep"
• Change attribution of chats from Claude Code to "Agent" rather than "Assistant"
• Include the model and model version in the "Agent" attribution
• Don't include the isMeta/true user messages "Caveat: The messages below were generated by the user.." in the markdown file
• Good markdown formatting for / commands entered by the user in Claude Code
• Better markdown file naming by skipping isMeta and / commands from the user message for naming the filename
• Don't include the <system-reminder>...</system-reminder> about malicious content in the generated markdown on "Read" tool results

🔧 CLI Configuration & Commands

• Moved from a flag based CLI to one based on commands
  • Commands for: run, sync, check, help, version
  • Flags for: --log, --verbose, --silent, --no-version-check, --no-usage-analytics
• Command specific help, e.g. specstory help sync
• Fully styled help via Fang
• Improved help text and example usage

🐛 Bug Fixes

• Remove the proactive check for Claude Code in the PATH, as this no longer works with Anthropic's self-managed install approach (~/.claude/local/claude with a claude alias)
• Instead of defaulting to claude when no Claude Code Command (-c) is provided, first check for the presence of ~/.claude/local/claude and use that as the default if present, to work with Anthropic's self-managed install approach
• If ~ is used in the Claude Code Command (-c) it was being treated literally, rather than expanded

v0.3.0 2025-07-03

✏️ Markdown Enhancements

• Generate markdown files with formatted todos including priority indicators (🔥/🌡️/❄️) and completion status ([ ], [⚡], [X]) for the TodoWrite tool

⚙️ Improvements

• Added progress and summary output to runs of the -s sync markdown command
• Add result output to runs of the -u single session command

🔧 CLI Configuration & Commands

• Added --silent mode to suppress output during single session (-u) or sync (-s)

🐛 Bug Fixes

• Flag validation - Using --silent and -v flags together returns an error

v0.2.0 2025-07-01

✏️ Markdown Enhancements

• Now when the user message to Claude Code consists of just an image, or includes one or more images, specstory will include this fact in the generated markdown file.
• Now when Claude Code breaks up user messages into multiple parts, specstory includes all the parts in the generated markdown file, not just the first part.

🐛 Bug Fixes

• Fixed an issue where specstory would not find the Claude Code ~/.claude/projects directory for the project if the project path contained the _ character.
• Fixed an issue where running with the -u flag when there was no .specstory/history directory would cause specstory to exit with an error

v0.1.0 2025-06-26

⚙️ Improvements

• Deterministic filenames - Implemented deterministic filenames for consistent builds

📦 Distribution & Build

• Automatic version checking - Check for newer versions of specstory and output a message if available
• Version check bypass - Use --no-version-check to disable version checking for current run

🔧 CLI Configuration & Commands

• Installation verification - Added --check-install command for system validation
• Logging control - New --log flag for enhanced debugging capabilities
• Flag validation - Using -s and -u flags together now properly returns an error
• Analytics control - Use --no-usage-analytics to disable analytics for current run
• Version check bypass - Use --no-version-check to disable version checking for current run

📊 Analytics

• Analytics control - Use --no-usage-analytics to disable analytics for current run
• Session tracking - Enhanced analytics integration with configurable opt-out options

🐛 Bug Fixes

• Sidechain stability - Fixed hanging issues in sidechain operations
• Exception handling - Resolved exception errors in sidechain processing
• Duplicate prevention - CLI no longer writes duplicate files
• Major stability fix - Resolved critical stability issue (the big fix)

v0.0.3 2025-06-20

📦 Distribution & Build

• Version updates - Update pinned CLI version

📊 Analytics

• Shared analytics ID - CLI now sync analytics IDs (macOS only)
• PostHog tracking - Added basic PostHog tracking of activated sessions when CLI runs in interactive mode

v0.0.2 2025-06-20

✏️ Markdown Enhancements

• Tool argument display - Show grep tool arguments in markdown output
• Tool result messages - Tool outputs now properly display as assistant responses

⚙️ Improvements

• Better error handling - No longer checks if CLI path exists, just tries to run and shows errors if they occur

📦 Distribution & Installation

• Homebrew support - Fixed Homebrew setup and artifact URLs for easier installation
• Dual archive format - CLI now distributed as both tar.gz and zip archives
• Build improvements - Added ID to archives for better build tracking

🔧 CLI Configuration & Commands

• Verbose flag - Added -v verbose flag to show informational logging only when needed
• Updated flags - Improved CLI flag handling and configuration

v0.3.0

Specstory CLI Changelog

v0.3.0 2025-07-03

✏️ Markdown Enhancements

• Generate markdown files with formatted todos including priority indicators (🔥/🌡️/❄️) and completion status ([ ], [⚡], [X]) for the TodoWrite tool

⚙️ Improvements

• Added progress and summary output to runs of the -s sync markdown command
• Add result output to runs of the -u single session command

🔧 CLI Configuration & Commands

• Added --silent mode to suppress output during single session (-u) or sync (-s)

🐛 Bug Fixes

• Flag validation - Using --silent and -v flags together returns an error

v0.2.0 2025-07-01

✏️ Markdown Enhancements

• Now when the user message to Claude Code consists of just an image, or includes one or more images, specstory will include this fact in the generated markdown file.
• Now when Claude Code breaks up user messages into multiple parts, specstory includes all the parts in the generated markdown file, not just the first part.

🐛 Bug Fixes

• Fixed an issue where specstory would not find the Claude Code ~/.claude/projects directory for the project if the project path contained the _ character.
• Fixed an issue where running with the -u flag when there was no .specstory/history directory would cause specstory to exit with an error

v0.1.0 2025-06-26

⚙️ Improvements

• Deterministic filenames - Implemented deterministic filenames for consistent builds

📦 Distribution & Build

• Automatic version checking - Check for newer versions of specstory and output a message if available
• Version check bypass - Use --no-version-check to disable version checking for current run

🔧 CLI Configuration & Commands

• Installation verification - Added --check-install command for system validation
• Logging control - New --log flag for enhanced debugging capabilities
• Flag validation - Using -s and -u flags together now properly returns an error
• Analytics control - Use --no-usage-analytics to disable analytics for current run
• Version check bypass - Use --no-version-check to disable version checking for current run

📊 Analytics

• Analytics control - Use --no-usage-analytics to disable analytics for current run
• Session tracking - Enhanced analytics integration with configurable opt-out options

🐛 Bug Fixes

• Sidechain stability - Fixed hanging issues in sidechain operations
• Exception handling - Resolved exception errors in sidechain processing
• Duplicate prevention - CLI no longer writes duplicate files
• Major stability fix - Resolved critical stability issue (the big fix)

v0.0.3 2025-06-20

📦 Distribution & Build

• Version updates - Update pinned CLI version

📊 Analytics

• Shared analytics ID - CLI now sync analytics IDs (macOS only)
• PostHog tracking - Added basic PostHog tracking of activated sessions when CLI runs in interactive mode

v0.0.2 2025-06-20

✏️ Markdown Enhancements

• Tool argument display - Show grep tool arguments in markdown output
• Tool result messages - Tool outputs now properly display as assistant responses

⚙️ Improvements

• Better error handling - No longer checks if CLI path exists, just tries to run and shows errors if they occur

📦 Distribution & Installation

• Homebrew support - Fixed Homebrew setup and artifact URLs for easier installation
• Dual archive format - CLI now distributed as both tar.gz and zip archives
• Build improvements - Added ID to archives for better build tracking

🔧 CLI Configuration & Commands

• Verbose flag - Added -v verbose flag to show informational logging only when needed
• Updated flags - Improved CLI flag handling and configuration

v0.2.0

v0.2.0 2025-07-01

⚙️ Enhanced Features

• Now when the user message to Claude Code consists of just an image, or includes one or more images, specstory will include this fact in the generated markdown file.
• Now when Claude Code breaks up user messages into multiple parts, specstory includes all the parts in the generated markdown file, not just the first part.

🐛 Bug Fixes & Improvements

• Fixed an issue where specstory would not find the Claude Code ~/.claude/projects directory for the project if the project path contained the _ character.
• Fixed an issue where running with the -u flag when there was no .specstory/history directory would cause specstory to exit with an error

v0.1.0 2025-06-26

🔄 Version Management

• Automatic version checking - Check for newer versions of specstory and output a message if available
• Version check bypass - Use --no-version-check to disable version checking for current run

📊 Analytics & Usage Tracking

• Analytics control - Use --no-usage-analytics to disable analytics for current run
• Session tracking - Enhanced analytics integration with configurable opt-out options

🔧 CLI Configuration & Commands

• Installation verification - Added --check-install command for system validation
• Logging control - New --log flag for enhanced debugging capabilities
• Flag validation - Using -s and -u flags together now properly returns an error

🐛 Bug Fixes & Improvements

• Sidechain stability - Fixed hanging issues in sidechain operations
• Exception handling - Resolved exception errors in sidechain processing
• Duplicate prevention - CLI no longer writes duplicate files
• Major stability fix - Resolved critical stability issue (the big fix)

⚙️ Enhanced Features

• Deterministic filenames - Implemented deterministic filenames for consistent builds

v0.0.3 2025-06-20

📦 Distribution & Build

• Version updates - Update pinned CLI version

📊 Analytics Integration

• Shared analytics ID - CLI now sync analytics IDs (macOS only)
• PostHog tracking - Added basic PostHog tracking of activated sessions when CLI runs in interactive mode

v0.0.2 2025-06-20

• Better error handling - No longer checks if CLI path exists, just tries to run and shows errors if they occur
• Tool argument display - Show grep tool arguments in markdown output

📦 Distribution & Installation

• Dual archive format - CLI now distributed as both tar.gz and zip archives
• Homebrew support - Fixed Homebrew setup and artifact URLs for easier installation
• Build improvements - Added ID to archives for better build tracking

🔧 CLI Configuration

Logging & Debugging

• Verbose flag: Added verbose flag to show informational logging only when needed
• Tool result messages: Tool outputs now properly display as assistant responses
• Updated flags: Improved CLI flag handling and configuration

v0.1.0

Specstory CLI Changelog

🔄 Version Management

• Automatic version checking - Check for newer versions of specstory and output a message if available
• Version check bypass - Use --no-version-check to disable version checking for current run

📊 Analytics & Usage Tracking

• Analytics control - Use --no-usage-analytics to disable analytics for current run
• Session tracking - Enhanced analytics integration with configurable opt-out options

🔧 CLI Configuration & Commands

• Installation verification - Added --check-install command for system validation
• Logging control - New --log flag for enhanced debugging capabilities
• Flag validation - Using -s and -u flags together now properly returns an error

🐛 Bug Fixes & Improvements

• Sidechain stability - Fixed hanging issues in sidechain operations
• Exception handling - Resolved exception errors in sidechain processing
• Duplicate prevention - CLI no longer writes duplicate files
• Major stability fix - Resolved critical stability issue (the big fix)

⚙️ Enhanced Features

• Deterministic filenames - Implemented deterministic filenames for consistent builds

v0.0.3

Specstory CLI Changelog

📦 Distribution & Build

Version updates - Update pinned CLI version

📊 Analytics Integration

Shared analytics ID - CLI now sync analytics IDs (macOS only)
PostHog tracking - Added basic PostHog tracking of activated sessions when CLI runs in interactive mode

v0.0.2

Specstory CLI Changelog

• Better error handling - No longer checks if CLI path exists, just tries to run and shows errors if they occur
• Tool argument display - Show grep tool arguments in markdown output

📦 Distribution & Installation

• Dual archive format - CLI now distributed as both tar.gz and zip archives
• Homebrew support - Fixed Homebrew setup and artifact URLs for easier installation
• Build improvements - Added ID to archives for better build tracking

🔧 CLI Configuration

Logging & Debugging

• Verbose flag: Added verbose flag to show informational logging only when needed
• Tool result messages: Tool outputs now properly display as assistant responses
• Updated flags: Improved CLI flag handling and configuration