v0.1.10: Fix session directory truncation and rename corruption

What's New

Fix session directory truncation and rename corruption

• sanitize_dirname() had a hardcoded 50-char limit that silently truncated long session names in directory names (e.g., ...-pt2 became ...-pt). Now dynamically computes budget from the 255-char filesystem limit.
• _rename_files_for_session_change() used blind str.replace() which corrupted files like transcript.jsonl when the old session name was a common substring (e.g., c in transcript). Now skips non-log files and uses structural regex targeting.
• Added 15 pytest tests validating rename and truncation behavior.
• Closes #17

See v0.1.9 for the cross-platform Node.js launcher, PEP 668 pip escalation, and auto-install fixes shipped earlier in this release cycle.

Install / Update

# First time
claude plugin marketplace add "DazzleML/claude-session-logger"
claude plugin install session-logger@dazzle-claude-plugins

# Update existing
claude plugin marketplace remove dazzle-claude-plugins
claude plugin marketplace add "DazzleML/claude-session-logger"
claude plugin install session-logger@dazzle-claude-plugins

v0.1.9: Cross-platform reliability and PEP 668 compatibility

What's New

Three releases in one session! The focus was on fixing plugin reliability across platforms.

v0.1.9: Escalating pip install for PEP 668 compatibility

• _ensure_dazzle_filekit() now tries three pip strategies for maximum compatibility:
  1. Normal pip install (Windows, venvs, Ubuntu 22.04)
  2. pip install --user (restricted global installs)
  3. pip install --break-system-packages (Ubuntu 24.04+ with PEP 668)
• install.py now actually installs dazzle-filekit instead of saying "Optionally"
• Closes #18

v0.1.8: Cross-platform Node.js hook launcher

• Replace direct python call in hooks.json with node run-hook.mjs
• Finds Python 3 on any platform (python3 on Unix, python on Windows)
• Warns when CLAUDE_PLUGIN_ROOT env var is missing (npm-installed Claude Code)
• Updated installation docs with official Anthropic links and npm migration guidance
• Closes #19

v0.1.7: Auto-install dazzle-filekit, task description config, resilient error handling

• Auto-install dazzle-filekit if missing, with retry sentinel to avoid repeated pip attempts
• Add task_description_length config for controlling task log truncation
• Unify task filename generation to fix file proliferation (#15)
• Wrap main() in top-level exception handler so hooks never block Claude Code

Important: Native Claude Code installer required

The plugin system requires the native Claude Code installer, not the deprecated npm version. The npm version does not expand ${CLAUDE_PLUGIN_ROOT} in hook commands, causing hooks to fail silently.

# Install or upgrade to native installer
curl -fsSL https://claude.ai/install.sh | bash    # Linux/macOS
irm https://claude.ai/install.ps1 | iex           # Windows PowerShell

See Anthropic's migration guide for details.

Install / Update

# First time
claude plugin marketplace add "DazzleML/claude-session-logger"
claude plugin install session-logger@dazzle-claude-plugins

# Update existing
claude plugin marketplace remove dazzle-claude-plugins
claude plugin marketplace add "DazzleML/claude-session-logger"
claude plugin install session-logger@dazzle-claude-plugins

Tested On

• Windows 11 Pro (Git Bash) -- v2.1.92
• Ubuntu (native installer) -- v2.1.92

v0.1.4 - Enhanced Logging and Developer Tooling

Claude Session Logger v0.1.4

Real-time session logging, command history, and auto-naming for Claude Code. Watch Claude's tool calls as they happen, with easy-to-copy file paths and organized session logs.

What's New in v0.1.4

Enhanced Logging Format

• Grep glob filter (#6): Grep entries now show file glob filter alongside pattern

  {Grep: useTranslation | "*.tsx" }
  

• Write/Edit content preview (#7): Shows first 20 characters of content being written

  {Write: "path/file.txt" ← "# My Header\nThis..." }
  {Edit: "path/file.txt" ← "def new_func():\n..." }
  

• Agent context framework (#5): Foundation for identifying subagent tool calls

  • Format when detected: {Bash|Explore: command } or {Read|Plan: "path" }
  • Debug logging added to investigate available JSON fields

Bug Fixes

• Session resume detection (#9): SESSION START marker now written when resuming a session
  • Previously, resumed sessions didn't get new markers
  • Now correctly shows Run #1, Run #2, etc.

Developer Tools

• sync-versions.py: Centralized version management

  • --bump patch/minor/major to increment version
  • --set X.Y.Z to set version directly
  • --dev-refresh [VERSION...] to clear plugin cache for testing
  • --check to verify all files are in sync

• docs/dev.md: Developer guide with testing workflows, debugging tips, PR checklist

• Tool coverage (#8): Added EnterPlanMode, ExitPlanMode, TaskOutput, TaskStop

Installation

claude plugin marketplace add "DazzleML/claude-session-logger"
claude plugin install session-logger@dazzle-claude-plugins

Version History (v0.1.x)

Version	Key Change
v0.1.4	Enhanced logging (Grep glob, Write/Edit preview), session resume fix, dev tooling
v0.1.3	Plugin architecture fixes for marketplace installation
v0.1.2	Plugin marketplace docs, installation guide, release badge
v0.1.1	CI workflow fixes, log formatting improvements
v0.1.0	Initial release with core logging functionality

Platform Support

Platform	Status
Windows (Git Bash/MINGW64)	Tested
WSL / WSL2	Tested
Linux	Expected to work
macOS	Expected to work

v0.1.3 - Plugin Architecture Fixes

Claude Session Logger v0.1.3

Real-time session logging, command history, and auto-naming for Claude Code. Watch Claude's tool calls as they happen, with easy-to-copy file paths and organized session logs.

What's New in v0.1.3: Plugin Architecture Fixes

This release fixes critical issues that prevented the plugin from loading correctly via marketplace installation.

Working Installation Commands

The plugin now installs correctly using the marketplace system:

# From GitHub (recommended)
claude plugin marketplace add "DazzleML/claude-session-logger"
claude plugin install session-logger@dazzle-claude-plugins

# From local clone (for development)
claude plugin marketplace add "./"
claude plugin install session-logger@dazzle-claude-plugins

Plugin Manifest Fixes

• Removed invalid claude-code key from plugin.json
• Removed explicit hooks reference (auto-loaded by convention)
• Added required ./ prefix to paths

Hooks Configuration Fixes

• Added required outer hooks wrapper object
• Changed {plugin_dir} to ${CLAUDE_PLUGIN_ROOT} placeholder

Marketplace Schema Fix

• Changed .claude-plugin/marketplace.json from listing metadata schema to marketplace hosting schema
• Now uses self-hosted marketplace approach with owner and plugins array

Core Features (v0.1.x)

Feature	Description
Session Logging	Log all tool calls to ~/.claude/sesslogs/
Auto-Naming	Sessions named from working directory
Transcript Symlinks	Easy access via transcript.jsonl
Run Tracking	Track multiple runs within a session
Task Logging	Dedicated logging for TaskCreate/Update/List
/renameAI	AI-assisted session naming
/sessioninfo	Session state inspection

Version History (v0.1.x)

Version	Key Change
v0.1.3	Plugin architecture fixes for marketplace installation
v0.1.2	Plugin marketplace docs, installation guide, release badge
v0.1.1	CI workflow fixes, log formatting improvements
v0.1.0	Initial release with core logging functionality

Platform Support

Platform	Status
Windows (Git Bash/MINGW64)	Tested
WSL / WSL2	Tested
Linux	Expected to work
macOS	Expected to work

v0.1.2 - Installation & Documentation

Claude Session Logger v0.1.2

Real-time session logging, command history, and auto-naming for Claude Code. Watch Claude's tool calls as they happen, with easy-to-copy file paths and organized session logs.

What's New in v0.1.2: Installation & Documentation

This release focuses on making installation easier and more accessible, with proper documentation for multiple installation methods.

Plugin Marketplace Support

Added documentation for Claude Code's plugin marketplace installation:

claude plugin install session-logger

Note: Plugin architecture not yet validated. Manual installation (Method 3 in docs) is the tested approach.

Installation Documentation

New detailed installation guide at docs/installation.md covering:

• Plugin Marketplace installation
• Plugin Directory (--plugin-dir) for development
• Manual Installation (tested approach)
• Platform-specific notes
• Troubleshooting guide

README Improvements

• Added GitHub release badge
• Restructured with Quick Start before Project Structure
• Streamlined by moving detailed installation to separate docs

Log Formatting Fixes (v0.1.1)

Improved log entry formatting for better copy-paste workflow:

• Added space before closing } in log entries
• File paths now wrapped in double-quotes for VS Code path clicking
• PWD path in log entries now quoted for consistency

Before: {Read: C:\code\project\file.py}[C:\code\project]
After: {Read: "C:\code\project\file.py" }["C:\code\project"]

Core Features (v0.1.x)

Feature	Description
Session Logging	Log all tool calls to ~/.claude/sesslogs/
Auto-Naming	Sessions named from working directory
Transcript Symlinks	Easy access via transcript.jsonl
Run Tracking	Track multiple runs within a session
Task Logging	Dedicated logging for TaskCreate/Update/List
/renameAI	AI-assisted session naming
/sessioninfo	Session state inspection

Version History (v0.1.x)

Version	Key Change
v0.1.2	Plugin marketplace docs, installation guide, release badge
v0.1.1	CI workflow fixes, log formatting improvements
v0.1.0	Initial release with core logging functionality

Platform Support

Platform	Status
Windows (Git Bash/MINGW64)	Tested
WSL / WSL2	Tested
Linux	Expected to work
macOS	Expected to work

v0.1.0 - Initial Release

Real-time Session Logging for Claude Code

First release of claude-session-logger - a hook-based tool for real-time session monitoring.

Features

• Real-time logging to separate channels (sesslog, shell, tasks)
• Auto-naming sessions from working directory
• Transcript symlinks for easy discovery
• /renameAI command for AI-assisted session renaming
• /sessioninfo command for session details
• Cross-platform support via dazzle-filekit

Installation

# Copy hooks and commands
cp -r claude/hooks/* ~/.claude/hooks/
cp -r claude/commands/* ~/.claude/commands/

# Install dependency
pip install dazzle-filekit

# Configure settings.json (see README)

Requirements

• Claude Code v1.0+
• Python 3.8+
• dazzle-filekit >= 0.2.1

See README for full documentation.