my-vault/CHANGELOG.md

Changelog

All notable changes to claudesidian will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

0.13.0 - 2025-01-17

Added

• New /install-claudesidian-command for creating shell alias/function to launch vault from anywhere
• iCloud Drive vault detection and import support in /init-bootstrap (macOS only)
• Fish shell support for launcher command with proper function syntax
• Comprehensive user input path validation with helpful error messages
• Platform detection for cross-platform compatibility (Linux, macOS, Windows)

Fixed

• Critical shell injection vulnerability in launcher command with proper path escaping
• Backup creation before modifying shell configuration files
• iCloud sync state checking with soft warnings for incomplete downloads
• Shell detection now uses default shell instead of current session shell
• Existing alias/function replacement with user confirmation
• Improved error handling documentation with explanations

Security

• Path escaping for vault paths with spaces, quotes, and special characters
• Timestamped backups before modifying shell configs
• Input validation for user-provided vault paths
• Security considerations section in documentation

0.12.1 - 2025-01-17

Fixed

• Improved upgrade command to prevent interactive prompts and hanging
• Enhanced upgrade command with explicit backup steps and non-interactive file replacement
• Refined upgrade command based on real usage feedback for better reliability
• Applied linting fixes to upgrade command for code quality

0.12.0 - 2025-01-17

Added

• New /download-attachment command for downloading web content and files to Obsidian attachments folder
• New /pull-request command for creating PRs with intelligent change analysis and description generation
• Both commands integrate seamlessly with Obsidian's vault structure

Fixed

• Security improvements in download command based on PR review feedback
• Code formatting to pass lint checks

0.11.0 - 2025-01-17

Added

• Comprehensive linting and formatting setup with ESLint and Prettier
• Configuration files organized in .config/ folder for better project structure
• GitHub Action workflow for automated lint checks on pull requests
• Package manager specification for consistent dependency management

Fixed

• Resolved lonely if ESLint warning for cleaner code
• GitHub Action configuration for proper pnpm setup
• Added packageManager field to ensure consistent tooling across environments

0.10.1 - 2025-01-15

Fixed

• Corrected GitHub Action configuration to use claude_args instead of allowed_tools
• Fixed workflow validation error for allowed tools parameter

0.10.0 - 2025-01-15

Added

• GitHub Actions workflow for Claude Code integration
• Claude can now respond to @claude mentions in issues and PRs
• Configured permissions for Claude to create PRs and push changes
• Added allowed tools configuration for pnpm, git, gh CLI operations
• User restriction to repository owner for security
• Development workflow option in init-bootstrap
  • Personal vault users: Removes .github folder
  • Contributors: Keeps GitHub workflows for development

0.9.2 - 2025-01-14

Fixed

• Corrected Firecrawl script examples to use npm run commands
• Added contributing guideline about reviewing AI-generated content before submission

Removed

• Removed Common Patterns section from README (redundant)

0.9.1 - 2025-01-14

Changed

• Enhanced Gemini Vision documentation to explain direct image/PDF processing benefits
• Enhanced Firecrawl documentation to explain full-text capture and context preservation
• Added detailed API key setup instructions for both Gemini and Firecrawl

Removed

• Removed Essential Workflows section from README (redundant with command descriptions)

0.9.0 - 2025-01-14

Added

• Enhanced upgrade command documentation with detailed usage examples and safety features
• Contributing section with guidelines for community contributions
• MIT license file for clear open-source licensing

Changed

• Improved documentation clarity on Claude Code commands vs agents distinction
• Updated contributing guidelines to encourage PRs for commands, agents, and core updates

Removed

• Removed thinking-partner agent (keeping slash command only)

0.8.8 - 2025-01-13

Fixed

• Added critical warnings to upgrade command documentation
• Emphasized requirement to show diffs before applying changes
• Added correct vs wrong implementation examples
• Prevents loss of user customizations during upgrades

0.8.7 - 2025-01-13

Fixed

• Release command now automatically creates GitHub release using gh CLI
• Prevents missing GitHub releases (like v0.8.2-v0.8.5 were)
• Extracts release notes from CHANGELOG.md for GitHub release body

0.8.6 - 2025-01-13

Changed

• Improved semantic versioning guidelines in release command with clearer decision guide

0.8.5 - 2025-01-13

Fixed

• Upgrade command now works without git connection for disconnected users
• Clone latest version to .tmp/ directory instead of requiring upstream remote
• Use .tmp/ instead of /tmp/ to hide upgrade files from Obsidian
• Added user choice prompt when local modifications are detected
• Added verification step to ensure all files were properly addressed
• Added .tmp/ to .gitignore for cleaner repository

0.8.4 - 2025-01-13

Fixed

• Simplified upgrade command to systematically check all system files
• Created upgrade checklist to track progress file-by-file
• Filtered upgrades to only claudesidian system files, not user content
• Added explicit file-by-file diff review before updating
• Made upgrade process resumable with checklist tracking

0.8.3 - 2025-01-13

Fixed

• Improved init-bootstrap vault selection for multiple vaults
• Added explicit confirmation before importing any vault
• Enhanced user identification prompts with better explanations
• Added disambiguation prompts to find the right person when researching
• Clear instructions to never proceed without explicit vault confirmation

0.8.2 - 2025-01-13

Fixed

• Improved SessionStart hook formatting with arrow indicators for commands
• Fixed update notification display to show clean output instead of raw JSON
• Enhanced visual layout of first-run and update messages

0.8.1 - 2025-01-13

Changed

• Updated README with comprehensive feature descriptions including:
  • Smart vault analysis and pattern detection capabilities
  • User research and profile building features
  • Automatic update notification system
  • Web research capabilities with Firecrawl
  • Complete list of available commands including /upgrade

0.8.0 - 2025-01-13

Added

• Automatic update check on session start
• SessionStart hook that fetches latest version from GitHub and compares to local
• Update notifications when newer versions are available
• check-updates npm script for version comparison
• Works even after disconnecting from original repository

Changed

• Enhanced release command documentation with clearer semantic versioning guidelines
• Better guidance on when to use feat: vs fix: vs refactor: in commits

0.7.0 - 2025-01-13

Added

• Comprehensive vault analysis using tree, note sampling, and pattern detection
• Enhanced profile building with URL fetching and custom context
• Dynamic date generation for timestamps in CLAUDE.md
• "Later" option for Gemini Vision and Firecrawl setup
• Multiple vault import options (yes/no/skip/path)
• Deeper research capabilities with disambiguation confirmation

Changed

• init-bootstrap now analyzes vault structure before importing
• Always confirms user identity even with single search result
• Waits to create folders until after organization method selection
• Detects plugins and attachments automatically instead of asking
• Firecrawl presented as research game-changer with better explanation
• Profile building includes comprehensive background from provided URLs

Fixed

• Correct file counting without depth limits
• Proper ordering of import before personalization questions
• More accurate detection of user preferences from existing vault

0.6.0 - 2025-01-13

Added

• Intelligent vault import that preserves existing structure in OLD_VAULT folder
• Auto-detection of existing Obsidian vaults by searching for .obsidian folders
• User research and disambiguation for personalized setup
• Automatic detection of file naming patterns and folder organization
• Vault configuration saved to .claude/vault-config.json for future reference
• Educational explanations during each setup step
• Support for both pnpm and npm package managers
• Comprehensive Obsidian file copying (plugins, trash, settings)
• Clear examples for folder naming when cloning repository

Changed

• init-bootstrap now imports entire vault structure safely without data loss
• Gemini Vision and Firecrawl prompts clarify tools are already included
• README includes examples of custom folder names when cloning
• Removed unnecessary questions by detecting patterns automatically

0.5.0 - 2025-01-13

Added

• First-run welcome message using SessionStart hook
• FIRST_RUN marker file to detect fresh installations
• Markdown-formatted welcome prompt with setup instructions
• Automatic detection and guidance for new users

Changed

• init-bootstrap now removes FIRST_RUN marker after setup completion
• Hook configuration uses inline commands (no external scripts needed)

0.4.0 - 2025-01-13

Added

• Simplified setup process with enhanced init-bootstrap command:
  • Automatic disconnection from original repository
  • Folder rename assistance for non-git users
  • Support for both git clone and ZIP download methods
  • Clear prompts for importing existing Obsidian vaults
• Multiple setup paths in README for different user skill levels

Changed

• init-bootstrap now handles complete environment setup including git management
• README updated with clearer Quick Start instructions for both technical and non-technical users

0.3.1 - 2025-01-13

Fixed

• Removed CLAUDE.md and settings.local.json from repository tracking
• These user-specific files are now generated locally by init-bootstrap
• Added both files to .gitignore to prevent accidental commits
• Clean repository structure for new users

0.3.0 - 2025-01-13

Added

• Intelligent upgrade command (/upgrade) with AI-powered semantic merging
• Smart conflict resolution that preserves user customizations while adding new features
• Automatic backup system with rollback capabilities
• Selective update categories (AI-mergeable, auto-safe, protected)
• Based on 2025 best practices for LLM-powered code migration

0.2.3 - 2025-01-13

Changed

• Updated init-bootstrap command and settings configuration

0.2.2 - 2025-01-13

Fixed

• Corrected all documentation to use proper slash command syntax (/command-name)
• Fixed examples showing incorrect 'claude run' syntax
• Updated README, CLAUDE.md, install.sh, and command docs

0.2.1 - 2025-01-13

Changed

• Updated README to use init-bootstrap command instead of install.sh
• Simplified Quick Start instructions to 2-step process
• Added examples of pre-configured commands in README

0.2.0 - 2025-01-13

Added

• Release command for automated version management and releases
• Gemini Vision video analysis support:
  • Local video files (MP4, AVI, MOV, WebM, MKV, WMV, FLV, 3GP, M4V)
  • Direct YouTube URL analysis without download
  • Automatic video processing state detection
• Updated documentation with video analysis examples

Changed

• Enhanced init-bootstrap command with full environment setup including MCP configuration
• Updated Gemini Vision MCP server to support video formats

0.1.0 - 2025-01-13

Added

• Initial release of claudesidian - Claude Code + Obsidian starter kit
• PARA method folder structure (00_Inbox through 06_Metadata)
• Bootstrap initialization system via claude run init-bootstrap
• Pre-configured Claude Code commands:
  • thinking-partner - Collaborative thinking mode
  • inbox-processor - Organize captures
  • research-assistant - Deep dive into topics
  • daily-review - End of day reflection
  • weekly-synthesis - Find patterns in your week
  • create-command - Build new custom commands
  • de-ai-ify - Remove AI writing patterns
  • add-frontmatter - Add metadata to notes
  • init-bootstrap - Interactive setup wizard
• Claude Code agents for specialized workflows
• Helper scripts:
  • firecrawl-batch.sh - Batch web scraping
  • firecrawl-scrape.sh - Single URL scraping
  • fix-renamed-links.js - Fix broken links after renames
  • update-attachment-links.js - Update attachment references
  • transcript-extract.sh - Extract YouTube transcripts
  • vault-stats.sh - Show vault statistics
• Attachment management commands via pnpm
• Gemini Vision MCP server for image/PDF analysis (optional)
• CLAUDE-BOOTSTRAP.md template for configuration
• Comprehensive README with setup instructions
• Install script for automated setup
• Git integration with proper .gitignore

Changed

• Replaced static CLAUDE.md with dynamic init-bootstrap command

Security

• API keys stored in environment variables
• .mcp.json gitignored for security