ccexport 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ccc4798123b459b9c2f9eb8637d17c28d5168ac7f0ea965c23b56543636f832e
-  data.tar.gz: 30e8610415bf25386cd49dfec6a0e6f4b0ad8bfa401d1968dfdea4cff50443a9
+  metadata.gz: 6d1615cbaeacf17cc0f054e7d997e0e1a53b739511f2086c410340cfb2816d2d
+  data.tar.gz: e4b856098953850b6857395c3ca9a5054c91033161f1d1bb74bf8c7bf85fe0f8
 SHA512:
-  metadata.gz: f33cbe1749351761a15927f669728b4fde3ff8e0c4043691b8ce53dd4ca990e14aff410d241e5269639661d587668e8f348d6b01cc1bfd73211d40b13a3da256
-  data.tar.gz: d687d278ab543a97b1ec4e875654029c922f1a069aa588f998977181fb27c2778296288e1009e8afdc42e9098f4a0997c8047cddeaf40919c36faa23b95cfdf7
+  metadata.gz: 7bf47b9c630fcb1f06efcfd4cd4ab3a23f6881812fdbe733a1272193af23f47f231ca0751b60586766cdd99a8e3649630639fd667ebc2cf81252b4719dffc85a
+  data.tar.gz: d9694653205b5b27818f0721dd43df868375d3c4a878beed201d234427600df1e6dda751626e4f07d84f1660a1f58ccc5a5ec49e245a5c76f21355667d2c14ef

data/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-05-06
+
+- Add `--session ID` option to process a specific session. Thanks to @kopyl
+- Add `--clean` option to remove thinking and tool use from output. Thanks to @kopyl
+- Add `--stdout` option to write markdown to stdout instead of a file (implies `--silent`), enabling piping to other tools such as `gh gist create`. Inspired by @kopyl
+
 ## [0.1.0] - 2024-08-17
 
 ### Added
@@ -20,4 +26,4 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Command-line interface with extensive options
 - Support for both single session and multi-session exports
 - Path relativization for project files
-- Comprehensive test suite with RSpec
+- Comprehensive test suite with RSpec

data/CLAUDE.md

@@ -153,4 +153,44 @@ brew install cmark-gfm
 - 96 RSpec tests covering all major functionality
 - Test fixtures in `spec/fixtures/` with real JSONL data samples
 - Mocking of external dependencies (TruffleHog, cmark-gfm, system commands)
-- Comprehensive secret detection testing with realistic secret formats
+- Comprehensive secret detection testing with realistic secret formats
+
+## Gem Distribution
+
+### RubyGem Structure
+- **Gem Name**: `ccexport`
+- **Version**: Managed in `lib/ccexport/version.rb`
+- **Executable**: `exe/ccexport` (installed globally as `ccexport` command)
+- **Entry Point**: `lib/ccexport.rb` (requires all necessary components)
+
+### Dependency Management
+**Automatic Installation**: The `exe/ccexport` executable includes automatic dependency checking and installation:
+
+1. **Dependency Detection**: Checks for `trufflehog` and `cmark-gfm` using `which` command
+2. **Auto-Install**: If Homebrew is available, automatically runs `brew install` for missing dependencies
+3. **Graceful Fallback**: Provides installation instructions and exits if dependencies can't be auto-installed
+4. **Skip Option**: `--skip-dependency-check` flag for advanced users or CI environments
+5. **Silent Mode**: Respects `--silent` flag for dependency operations
+
+### Build and Release Process
+```bash
+# Build gem locally
+gem build ccexport.gemspec
+
+# Install locally for testing
+gem install ./ccexport-0.1.0.gem
+
+# Test functionality
+ccexport --help
+```
+
+**Files Excluded from Gem**:
+- Test files (`spec/`)
+- Development scripts (`debug_compacted.rb`, `generate_vibe_samples`)
+- Example outputs (`VIBE*`, `claude-conversations/`)
+- Build artifacts (`*.gem`)
+
+### Installation Paths
+- **Quick Install**: `gem install ccexport` (dependencies auto-installed with Homebrew)
+- **Development**: Clone repo, `bundle install`, manual dependency installation
+- **Manual Setup**: Detailed Ruby + Homebrew installation instructions for non-developers

data/README.md

@@ -45,6 +45,8 @@ I created this tool because, as I'm exploring using agentic coding tools, I've f
 gem install ccexport
 ```
 
+**Note**: If you have Homebrew installed, ccexport will automatically install missing dependencies (TruffleHog and cmark-gfm) when you first run it. If you don't have Homebrew, see the full setup instructions below.
+
 ### Full Setup (For non-Ruby developers)
 
 If you don't have Ruby installed or aren't familiar with Ruby development, follow these steps:
@@ -173,18 +175,72 @@ rbenv global 3.4.3
 ruby --version  # Should show Ruby 3.4.3
 ```
 
-#### 4. Install ccexport and dependencies
+#### 4. Install ccexport
 
 ```bash
 # Install the gem
 gem install ccexport
 
-# Install required external tools (if you installed Homebrew)
-brew install trufflehog cmark-gfm
+# Run ccexport - it will automatically install dependencies via Homebrew if needed
+ccexport --help
+```
+
+**If the `ccexport` command is not found after installation:**
+
+<details>
+<summary>Refresh your Ruby version manager (click to expand)</summary>
+
+```bash
+# rbenv users
+rbenv rehash
+
+# RVM users
+rvm reload
+
+# asdf users
+asdf reshim ruby
+
+# mise users
+mise reshim
+```
+
+Then try running `ccexport --help` again.
+</details>
+
+<details>
+<summary>Add the gem bin directory to your PATH (plain Homebrew Ruby, no version manager)</summary>
+
+If you installed Ruby directly via `brew install ruby` and aren't using a version manager, the gem executables may not be on your PATH. Add this line to your shell profile:
+
+```bash
+export PATH="$(gem environment gemdir)/bin:$PATH"
+```
+
+Which file to add it to depends on your shell:
+
+- **zsh** (default on macOS Catalina and later):
+  ```bash
+  echo 'export PATH="$(gem environment gemdir)/bin:$PATH"' >> ~/.zprofile
+  ```
+- **bash** (default on older macOS or if you've switched):
+  ```bash
+  echo 'export PATH="$(gem environment gemdir)/bin:$PATH"' >> ~/.bash_profile
+  ```
+- **fish**: `~/.config/fish/config.fish`, using `fish_add_path (gem environment gemdir)/bin`
+
+After running the command, restart your terminal or run `source ~/.zprofile` (adjust for your shell), then try `ccexport --help` again.
+</details>
 
+**That's it!** When you first run ccexport, it will automatically detect and install any missing dependencies (TruffleHog and cmark-gfm) if you have Homebrew installed.
+
+**Manual dependency installation** (only needed if you don't have Homebrew):
+```bash
 # If you're using system package managers instead of Homebrew:
 # - TruffleHog: https://github.com/trufflesecurity/trufflehog#installation
 # - cmark-gfm: May require building from source on some Linux distributions
+
+# To skip dependency checking entirely:
+ccexport --skip-dependency-check
 ```
 
 ### From Source (Development)
@@ -196,8 +252,12 @@ brew install trufflehog cmark-gfm
 ### Prerequisites Summary
 
 - **Ruby**: 3.0.0 or higher (3.4.3 recommended)
+- **Homebrew**: Recommended for automatic dependency installation ([installation guide](https://brew.sh))
+- **TruffleHog** and **cmark-gfm**: Automatically installed via Homebrew when you first run ccexport
+
+**Manual installation only needed if you don't have Homebrew:**
 - **TruffleHog**: For secret detection ([installation guide](https://github.com/trufflesecurity/trufflehog#installation))
-- **cmark-gfm**: For HTML preview generation (`brew install cmark-gfm` on macOS)
+- **cmark-gfm**: For HTML preview generation
 
 ## Usage
 
@@ -260,6 +320,15 @@ ccexport --preview --template github
 # Process specific JSONL file
 ccexport --jsonl /path/to/conversation.jsonl --out specific-conversation.md
 
+# Process specific session
+ccexport --session aee5189e-cdc7-42fd-9aa1-96ae42c12826
+
+# Write markdown to stdout (implies --silent)
+ccexport --today --stdout
+
+# Create a GitHub Gist from today's conversations
+ccexport --today --stdout | gh gist create -f claude.md
+
 # Silent mode (suppress all output)
 ccexport --silent
 
@@ -273,12 +342,15 @@ ccexport --in /path/to/project --from 2024-01-15 --out ./my-exports --timestamps
 - `--from DATE`: Filter messages from this date (YYYY-MM-DD or timestamp format from --timestamps output)
 - `--to DATE`: Filter messages to this date (YYYY-MM-DD or timestamp format from --timestamps output)
 - `--today`: Filter messages from today only (in your local timezone)
+- `--session ID`: Export a specific session
 - `--out PATH`: Custom output directory or specific file path (supports relative paths, use .md extension for specific file)
 - `--timestamps`: Show precise timestamps with each message for easy reference
+- `--clean`: Suppress the output of thinking and tool use
 - `--preview`: Generate HTML preview and open in browser automatically
 - `--no-open`: Generate HTML preview without opening in browser (requires --preview)
 - `--template NAME_OR_PATH`: HTML template name (from templates dir) or file path (default: default)
 - `--jsonl FILE`: Process a specific JSONL file instead of scanning directories
+- `--stdout`: Write markdown to stdout instead of a file (implies `--silent`); useful for piping to other tools
 - `-s`, `--silent`: Silent mode - suppress all output except errors
 - `--help`: Show usage information
 

data/TODO.md

@@ -0,0 +1,5 @@
+# TODO
+
+## Investigate JSONL entries without timestamps
+
+Some JSONL entries have no `timestamp` key. Currently `message_in_date_range?` treats them as in-range (includes them). It may be more correct to inherit the timestamp of the preceding entry — investigate whether that's the pattern in practice and update accordingly.

data/bin/ccexport

@@ -1,95 +1,5 @@
 #!/usr/bin/env ruby
 
-require_relative '../lib/claude_conversation_exporter'
-require 'optparse'
-require 'time'
+require_relative '../lib/ccexport'
 
-options = {}
-
-OptionParser.new do |parser|
-  parser.banner = "Usage: ccexport [options]"
-  
-  parser.on("--from DATE", "Filter messages from this date (YYYY-MM-DD)") do |date|
-    options[:from] = date
-  end
-  
-  parser.on("--to DATE", "Filter messages to this date (YYYY-MM-DD)") do |date|
-    options[:to] = date
-  end
-  
-  parser.on("--today", "Filter messages from today only") do
-    options[:today] = true
-  end
-  
-  parser.on("--in PATH", "Project path to export conversations from (default: current directory)") do |path|
-    options[:in] = path
-  end
-  
-  parser.on("--out PATH", "Output directory or file path (default: claude-conversations)") do |path|
-    options[:out] = path
-  end
-  
-  parser.on("--timestamps", "Show timestamps with each message") do
-    options[:timestamps] = true
-  end
-  
-  parser.on("--preview", "Generate HTML preview and open in browser") do
-    options[:preview] = true
-  end
-  
-  parser.on("--no-open", "Generate HTML preview without opening in browser (requires --preview)") do
-    options[:no_open] = true
-  end
-  
-  parser.on("--template NAME_OR_PATH", "HTML template name (from templates dir) or file path (default: default)") do |template|
-    options[:template] = template
-  end
-  
-  parser.on("--jsonl FILE", "Process a specific JSONL file instead of scanning directories") do |file|
-    options[:jsonl] = file
-  end
-  
-  parser.on("-s", "--silent", "Silent mode - suppress all output") do
-    options[:silent] = true
-  end
-  
-  parser.on("-h", "--help", "Show this help message") do
-    puts parser
-    exit
-  end
-end.parse!
-
-begin
-  # Validate options
-  if options[:no_open] && !options[:preview]
-    puts "Error: --no-open requires --preview" unless options[:silent]
-    exit 1
-  end
-  
-  if options[:jsonl] && !File.exist?(options[:jsonl])
-    puts "Error: JSONL file not found: #{options[:jsonl]}" unless options[:silent]
-    exit 1
-  end
-  
-  if options[:jsonl] && !options[:jsonl].end_with?('.jsonl')
-    puts "Error: File must have .jsonl extension: #{options[:jsonl]}" unless options[:silent]
-    exit 1
-  end
-  
-  project_path = options[:in] || Dir.pwd
-  output_dir = options[:out] || 'claude-conversations'
-  result = ClaudeConversationExporter.export(project_path, output_dir, options)
-  
-  # Generate preview if requested
-  if options[:preview]
-    # Use the actual output file if it was specified, otherwise use the directory
-    preview_target = result[:output_file] || output_dir
-    template_name = options[:template] || 'default'
-    ClaudeConversationExporter.generate_preview(preview_target, !options[:no_open], result[:leaf_summaries] || [], template_name, options[:silent])
-  end
-  
-  exit 0
-rescue StandardError => e
-  puts "Error: #{e.message}" unless options[:silent]
-  exit 1
-end
+CcExport::CLI.run

data/exe/ccexport

@@ -1,156 +1,5 @@
 #!/usr/bin/env ruby
 
 require 'ccexport'
-require 'optparse'
-require 'time'
 
-# Check for required external dependencies
-def check_dependencies(silent = false)
-  missing_deps = []
-  
-  # Check for TruffleHog
-  unless system('which trufflehog > /dev/null 2>&1')
-    missing_deps << 'trufflehog'
-  end
-  
-  # Check for cmark-gfm
-  unless system('which cmark-gfm > /dev/null 2>&1')
-    missing_deps << 'cmark-gfm'
-  end
-  
-  return if missing_deps.empty?
-  
-  puts "Missing required dependencies: #{missing_deps.join(', ')}" unless silent
-  
-  # Check if Homebrew is available
-  if system('which brew > /dev/null 2>&1')
-    puts "\nAttempting to install missing dependencies via Homebrew..." unless silent
-    
-    success = true
-    missing_deps.each do |dep|
-      puts "Installing #{dep}..." unless silent
-      unless system(silent ? "brew install #{dep} > /dev/null 2>&1" : "brew install #{dep}")
-        puts "Failed to install #{dep}" unless silent
-        success = false
-      end
-    end
-    
-    if success
-      puts "✅ All dependencies installed successfully!" unless silent
-      return
-    else
-      puts "❌ Some dependencies failed to install" unless silent
-    end
-  else
-    puts "\nHomebrew not found." unless silent
-  end
-  
-  unless silent
-    puts "\nPlease install the missing dependencies manually:"
-    puts "- TruffleHog: https://github.com/trufflesecurity/trufflehog#installation"
-    puts "- cmark-gfm: Install via your system package manager or from source"
-    puts "\nFor detailed installation instructions, see:"
-    puts "https://github.com/marcheiligers/ccexport#installation"
-    puts "\nAlternatively, install Homebrew and run ccexport again for automatic installation:"
-    puts "https://brew.sh"
-  end
-  
-  exit 1
-end
-
-options = {}
-
-OptionParser.new do |parser|
-  parser.banner = "Usage: ccexport [options]"
-  
-  parser.on("--from DATE", "Filter messages from this date (YYYY-MM-DD)") do |date|
-    options[:from] = date
-  end
-  
-  parser.on("--to DATE", "Filter messages to this date (YYYY-MM-DD)") do |date|
-    options[:to] = date
-  end
-  
-  parser.on("--today", "Filter messages from today only") do
-    options[:today] = true
-  end
-  
-  parser.on("--in PATH", "Project path to export conversations from (default: current directory)") do |path|
-    options[:in] = path
-  end
-  
-  parser.on("--out PATH", "Output directory or file path (default: claude-conversations)") do |path|
-    options[:out] = path
-  end
-  
-  parser.on("--timestamps", "Show timestamps with each message") do
-    options[:timestamps] = true
-  end
-  
-  parser.on("--preview", "Generate HTML preview and open in browser") do
-    options[:preview] = true
-  end
-  
-  parser.on("--no-open", "Generate HTML preview without opening in browser (requires --preview)") do
-    options[:no_open] = true
-  end
-  
-  parser.on("--template NAME_OR_PATH", "HTML template name (from templates dir) or file path (default: default)") do |template|
-    options[:template] = template
-  end
-  
-  parser.on("--jsonl FILE", "Process a specific JSONL file instead of scanning directories") do |file|
-    options[:jsonl] = file
-  end
-  
-  parser.on("-s", "--silent", "Silent mode - suppress all output") do
-    options[:silent] = true
-  end
-  
-  parser.on("--skip-dependency-check", "Skip checking for external dependencies") do
-    options[:skip_dependency_check] = true
-  end
-  
-  parser.on("-h", "--help", "Show this help message") do
-    puts parser
-    exit
-  end
-end.parse!
-
-# Check dependencies before proceeding (unless skipped)
-check_dependencies(options[:silent]) unless options[:skip_dependency_check]
-
-begin
-  # Validate options
-  if options[:no_open] && !options[:preview]
-    puts "Error: --no-open requires --preview" unless options[:silent]
-    exit 1
-  end
-  
-  if options[:jsonl] && !File.exist?(options[:jsonl])
-    puts "Error: JSONL file not found: #{options[:jsonl]}" unless options[:silent]
-    exit 1
-  end
-  
-  if options[:jsonl] && !options[:jsonl].end_with?('.jsonl')
-    puts "Error: File must have .jsonl extension: #{options[:jsonl]}" unless options[:silent]
-    exit 1
-  end
-  
-  project_path = options[:in] || Dir.pwd
-  output_dir = options[:out] || 'claude-conversations'
-  result = ClaudeConversationExporter.export(project_path, output_dir, options)
-  
-  # Generate preview if requested
-  if options[:preview]
-    # Use the actual output file if it was specified, otherwise use the directory
-    preview_target = result[:output_file] || output_dir
-    template_name = options[:template] || 'default'
-    ClaudeConversationExporter.generate_preview(preview_target, !options[:no_open], result[:leaf_summaries] || [], template_name, options[:silent])
-  end
-  
-  exit 0
-rescue StandardError => e
-  puts "Error: #{e.message}" unless options[:silent]
-  exit 1
-end
+CcExport::CLI.run

data/lib/ccexport/cli.rb

@@ -0,0 +1,158 @@
+# frozen_string_literal: true
+
+require 'optparse'
+require 'time'
+
+module CcExport
+  module CLI
+    def self.run(argv = ARGV)
+      options = {}
+
+      OptionParser.new do |parser|
+        parser.banner = "Usage: ccexport [options]"
+
+        parser.on("--from DATE", "Filter messages from this date (YYYY-MM-DD)") do |date|
+          options[:from] = date
+        end
+
+        parser.on("--to DATE", "Filter messages to this date (YYYY-MM-DD)") do |date|
+          options[:to] = date
+        end
+
+        parser.on("--today", "Filter messages from today only") do
+          options[:today] = true
+        end
+
+        parser.on("--in PATH", "Project path to export conversations from (default: current directory)") do |path|
+          options[:in] = path
+        end
+
+        parser.on("--out PATH", "Output directory or file path (default: claude-conversations)") do |path|
+          options[:out] = path
+        end
+
+        parser.on("--timestamps", "Show timestamps with each message") do
+          options[:timestamps] = true
+        end
+
+        parser.on("--preview", "Generate HTML preview and open in browser") do
+          options[:preview] = true
+        end
+
+        parser.on("--no-open", "Generate HTML preview without opening in browser (requires --preview)") do
+          options[:no_open] = true
+        end
+
+        parser.on("--template NAME_OR_PATH", "HTML template name (from templates dir) or file path (default: default)") do |template|
+          options[:template] = template
+        end
+
+        parser.on("--jsonl FILE", "Process a specific JSONL file instead of scanning directories") do |file|
+          options[:jsonl] = file
+        end
+
+        parser.on("--session ID", "Export a specific session by its UUID") do |id|
+          options[:session] = id
+        end
+
+        parser.on("--clean", "Export only visible conversation (no tool calls, thinking, or metadata)") do
+          options[:clean] = true
+        end
+
+        parser.on("--stdout", "Write markdown to stdout instead of a file (implies --silent)") do
+          options[:stdout] = true
+        end
+
+        parser.on("-s", "--silent", "Silent mode - suppress all output") do
+          options[:silent] = true
+        end
+
+        parser.on("--skip-dependency-check", "Skip checking for external dependencies") do
+          options[:skip_dependency_check] = true
+        end
+
+        parser.on("-h", "--help", "Show this help message") do
+          puts parser
+          exit
+        end
+      end.parse!(argv)
+
+      check_dependencies(options[:silent]) unless options[:skip_dependency_check]
+
+      begin
+        if options[:no_open] && !options[:preview]
+          puts "Error: --no-open requires --preview" unless options[:silent]
+          exit 1
+        end
+
+        if options[:jsonl] && !File.exist?(options[:jsonl])
+          puts "Error: JSONL file not found: #{options[:jsonl]}" unless options[:silent]
+          exit 1
+        end
+
+        if options[:jsonl] && !options[:jsonl].end_with?('.jsonl')
+          puts "Error: File must have .jsonl extension: #{options[:jsonl]}" unless options[:silent]
+          exit 1
+        end
+
+        project_path = options[:in] || Dir.pwd
+        output_dir = options[:out] || 'claude-conversations'
+        result = ClaudeConversationExporter.export(project_path, output_dir, options)
+
+        if options[:preview]
+          preview_target = result[:output_file] || output_dir
+          template_name = options[:template] || 'default'
+          ClaudeConversationExporter.generate_preview(preview_target, !options[:no_open], result[:leaf_summaries] || [], template_name, options[:silent])
+        end
+
+        exit 0
+      rescue StandardError => e
+        puts "Error: #{e.message}" unless options[:silent]
+        exit 1
+      end
+    end
+
+    def self.check_dependencies(silent = false)
+      missing_deps = []
+      missing_deps << 'trufflehog' unless system('which trufflehog > /dev/null 2>&1')
+      missing_deps << 'cmark-gfm' unless system('which cmark-gfm > /dev/null 2>&1')
+      return if missing_deps.empty?
+
+      puts "Missing required dependencies: #{missing_deps.join(', ')}" unless silent
+
+      if system('which brew > /dev/null 2>&1')
+        puts "\nAttempting to install missing dependencies via Homebrew..." unless silent
+
+        success = true
+        missing_deps.each do |dep|
+          puts "Installing #{dep}..." unless silent
+          unless system(silent ? "brew install #{dep} > /dev/null 2>&1" : "brew install #{dep}")
+            puts "Failed to install #{dep}" unless silent
+            success = false
+          end
+        end
+
+        if success
+          puts "✅ All dependencies installed successfully!" unless silent
+          return
+        else
+          puts "❌ Some dependencies failed to install" unless silent
+        end
+      else
+        puts "\nHomebrew not found." unless silent
+      end
+
+      unless silent
+        puts "\nPlease install the missing dependencies manually:"
+        puts "- TruffleHog: https://github.com/trufflesecurity/trufflehog#installation"
+        puts "- cmark-gfm: Install via your system package manager or from source"
+        puts "\nFor detailed installation instructions, see:"
+        puts "https://github.com/marcheiligers/ccexport#installation"
+        puts "\nAlternatively, install Homebrew and run ccexport again for automatic installation:"
+        puts "https://brew.sh"
+      end
+
+      exit 1
+    end
+  end
+end

data/lib/ccexport/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module CcExport
-  VERSION = "0.1.0"
-end
+  VERSION = "0.2.0"
+end

data/lib/ccexport.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "ccexport/version"
+require_relative "ccexport/cli"
 require_relative "claude_conversation_exporter"
 require_relative "secret_detector"
 

data/lib/claude_conversation_exporter.rb

@@ -167,7 +167,9 @@ class ClaudeConversationExporter
     @compacted_conversation_processed = false
     @options = options
     @show_timestamps = options[:timestamps] || false
-    @silent = options[:silent] || false
+    @clean = options[:clean] || false
+    @stdout = options[:stdout] || false
+    @silent = @stdout || options[:silent] || false
     @leaf_summaries = []
     @skipped_messages = []
     @secrets_detected = []
@@ -176,7 +178,11 @@ class ClaudeConversationExporter
   end
 
   def export
-    if @options[:jsonl]
+    if @options[:session]
+      session_file = find_session_file(@options[:session])
+      session_files = [session_file]
+      session_dir = File.dirname(session_file)
+    elsif @options[:jsonl]
       # Process specific JSONL file
       session_files = [File.expand_path(@options[:jsonl])]
       session_dir = File.dirname(session_files.first)
@@ -226,13 +232,20 @@ class ClaudeConversationExporter
       return { sessions_exported: 0, total_messages: 0 }
     end
 
+    markdown = format_combined_markdown(sessions)
+
+    if @stdout
+      $stdout.print(markdown)
+      return { sessions_exported: sessions.length, total_messages: total_messages, leaf_summaries: @leaf_summaries, output_file: nil }
+    end
+
     # Generate output path if not already specified
     if output_path.nil?
       filename = generate_combined_filename(sessions)
       output_path = File.join(output_dir, filename)
     end
 
-    File.write(output_path, format_combined_markdown(sessions))
+    File.write(output_path, markdown)
 
     # Write skip log if there were any skipped messages
     write_skip_log(output_path)
@@ -378,6 +391,7 @@ class ClaudeConversationExporter
 
   def message_in_date_range?(timestamp)
     return true unless @from_time || @to_time
+    return true if timestamp.nil?
 
     begin
       message_time = Time.parse(timestamp)
@@ -428,6 +442,17 @@ class ClaudeConversationExporter
     candidates.first
   end
 
+  def find_session_file(session_id)
+    projects_dir = File.join(@claude_home, 'projects')
+    filename = "#{session_id}.jsonl"
+
+    Dir.glob(File.join(projects_dir, '*', filename)).each do |path|
+      return path
+    end
+
+    raise "No session found with ID: #{session_id}"
+  end
+
   def encode_path(path)
     path.gsub('/', '-').gsub('_', '-')
   end
@@ -479,15 +504,26 @@ class ClaudeConversationExporter
             @compacted_conversation_processed = true
           end
         elsif data.key?('toolUseResult')
+          if @clean
+            # In clean mode, skip tool results entirely
+            next
+          end
           # Pair with previous tool_use
           if pending_tool_use
-            messages << format_combined_tool_use(pending_tool_use, data)
+            message = format_combined_tool_use(pending_tool_use, data)
+            messages << message if message
             pending_tool_use = nil
           end
         elsif data.key?('requestId') || regular_message?(data)
           # Check if this assistant message contains tool_use
           if tool_use_message?(data)
-            pending_tool_use = data # Hold for pairing with next toolUseResult
+            if @clean
+              # In clean mode, extract only text content from tool_use messages
+              message = format_regular_message(data)
+              messages << message if message
+            else
+              pending_tool_use = data # Hold for pairing with next toolUseResult
+            end
           else
             message = format_regular_message(data)
             if message
@@ -577,6 +613,8 @@ class ClaudeConversationExporter
 
     message_id = data.dig('message', 'id') || 'unknown'
 
+    return nil if content.nil?
+
     if content.is_a?(Array)
       result = extract_text_content(content, "message_#{message_id}")
       processed_content = result[:content]
@@ -590,7 +628,7 @@ class ClaudeConversationExporter
       processed_content = JSON.pretty_generate(content)
     end
 
-    return nil if processed_content.strip.empty?
+    return nil if processed_content.nil? || processed_content.strip.empty?
 
     # Fix nested backticks in regular content
     processed_content = fix_nested_backticks_in_content(processed_content)
@@ -680,14 +718,17 @@ class ClaudeConversationExporter
       if item.is_a?(Hash) && item['type'] == 'text' && item['text']
         parts << item['text']
       elsif item.is_a?(Hash) && item['type'] == 'thinking' && item['thinking']
+        next if @clean
         # Format thinking content as blockquote
         thinking_lines = item['thinking'].split("\n").map { |line| "> #{line}" }
         parts << thinking_lines.join("\n")
         has_thinking = true
       elsif item.is_a?(Hash) && item['type'] == 'tool_use'
+        next if @clean
         # Format tool_use without tool_result (will be paired later at message level)
         parts << format_tool_use(item, nil)
       else
+        next if @clean
         # Preserve other content types as JSON for now
         parts << JSON.pretty_generate(item)
       end
@@ -994,38 +1035,41 @@ class ClaudeConversationExporter
 
   def format_combined_markdown(sessions)
     md = []
-    title = get_markdown_title
-    md << "# #{title}"
-    md << ""
 
     if sessions.length == 1
       # Single session - use original format
       return format_markdown(sessions.first)
     end
 
-    # Multiple sessions - combined format
-    total_messages = sessions.sum { |s| s[:messages].length }
-    total_user = sessions.sum { |s| s[:messages].count { |m| m[:role] == 'user' } }
-    total_assistant = sessions.sum { |s| s[:messages].count { |m| m[:role] == 'assistant' } }
+    unless @clean
+      title = get_markdown_title
+      md << "# #{title}"
+      md << ""
 
-    md << "**Sessions:** #{sessions.length}"
-    md << "**Total Messages:** #{total_messages} (#{total_user} user, #{total_assistant} assistant)"
-    md << ""
+      # Multiple sessions - combined format
+      total_messages = sessions.sum { |s| s[:messages].length }
+      total_user = sessions.sum { |s| s[:messages].count { |m| m[:role] == 'user' } }
+      total_assistant = sessions.sum { |s| s[:messages].count { |m| m[:role] == 'assistant' } }
 
-    first_timestamp = sessions.map { |s| s[:first_timestamp] }.compact.min
-    last_timestamp = sessions.map { |s| s[:last_timestamp] }.compact.max
+      md << "**Sessions:** #{sessions.length}"
+      md << "**Total Messages:** #{total_messages} (#{total_user} user, #{total_assistant} assistant)"
+      md << ""
 
-    if first_timestamp
-      md << "**Started:** #{Time.parse(first_timestamp).getlocal.strftime('%B %d, %Y at %I:%M %p')}"
-    end
+      first_timestamp = sessions.map { |s| s[:first_timestamp] }.compact.min
+      last_timestamp = sessions.map { |s| s[:last_timestamp] }.compact.max
 
-    if last_timestamp
-      md << "**Last activity:** #{Time.parse(last_timestamp).getlocal.strftime('%B %d, %Y at %I:%M %p')}"
-    end
+      if first_timestamp
+        md << "**Started:** #{Time.parse(first_timestamp).getlocal.strftime('%B %d, %Y at %I:%M %p')}"
+      end
 
-    md << ""
-    md << "---"
-    md << ""
+      if last_timestamp
+        md << "**Last activity:** #{Time.parse(last_timestamp).getlocal.strftime('%B %d, %Y at %I:%M %p')}"
+      end
+
+      md << ""
+      md << "---"
+      md << ""
+    end
 
     # Process each session with separators
     sessions.each_with_index do |session, session_index|
@@ -1033,19 +1077,22 @@ class ClaudeConversationExporter
         md << ""
         md << "---"
         md << ""
-        md << "# Session #{session_index + 1}"
-        md << ""
-        md << "**Session ID:** `#{session[:session_id]}`"
 
-        if session[:first_timestamp]
-          md << "**Started:** #{Time.parse(session[:first_timestamp]).getlocal.strftime('%B %d, %Y at %I:%M %p')}"
-        end
+        unless @clean
+          md << "# Session #{session_index + 1}"
+          md << ""
+          md << "**Session ID:** `#{session[:session_id]}`"
 
-        user_count = session[:messages].count { |m| m[:role] == 'user' }
-        assistant_count = session[:messages].count { |m| m[:role] == 'assistant' }
+          if session[:first_timestamp]
+            md << "**Started:** #{Time.parse(session[:first_timestamp]).getlocal.strftime('%B %d, %Y at %I:%M %p')}"
+          end
 
-        md << "**Messages:** #{session[:messages].length} (#{user_count} user, #{assistant_count} assistant)"
-        md << ""
+          user_count = session[:messages].count { |m| m[:role] == 'user' }
+          assistant_count = session[:messages].count { |m| m[:role] == 'assistant' }
+
+          md << "**Messages:** #{session[:messages].length} (#{user_count} user, #{assistant_count} assistant)"
+          md << ""
+        end
       end
 
       # Add messages for this session
@@ -1064,27 +1111,30 @@ class ClaudeConversationExporter
 
   def format_markdown(session)
     md = []
-    title = get_markdown_title
-    md << "# #{title}"
-    md << ""
-    md << "**Session:** `#{session[:session_id]}`"
-    md << ""
-
-    if session[:first_timestamp]
-      md << "**Started:** #{Time.parse(session[:first_timestamp]).getlocal.strftime('%B %d, %Y at %I:%M %p')}"
-    end
 
-    if session[:last_timestamp]
-      md << "**Last activity:** #{Time.parse(session[:last_timestamp]).getlocal.strftime('%B %d, %Y at %I:%M %p')}"
-    end
+    unless @clean
+      title = get_markdown_title
+      md << "# #{title}"
+      md << ""
+      md << "**Session:** `#{session[:session_id]}`"
+      md << ""
+
+      if session[:first_timestamp]
+        md << "**Started:** #{Time.parse(session[:first_timestamp]).getlocal.strftime('%B %d, %Y at %I:%M %p')}"
+      end
 
-    user_count = session[:messages].count { |m| m[:role] == 'user' }
-    assistant_count = session[:messages].count { |m| m[:role] == 'assistant' }
+      if session[:last_timestamp]
+        md << "**Last activity:** #{Time.parse(session[:last_timestamp]).getlocal.strftime('%B %d, %Y at %I:%M %p')}"
+      end
+
+      user_count = session[:messages].count { |m| m[:role] == 'user' }
+      assistant_count = session[:messages].count { |m| m[:role] == 'assistant' }
 
-    md << "**Messages:** #{session[:messages].length} (#{user_count} user, #{assistant_count} assistant)"
-    md << ""
-    md << "---"
-    md << ""
+      md << "**Messages:** #{session[:messages].length} (#{user_count} user, #{assistant_count} assistant)"
+      md << ""
+      md << "---"
+      md << ""
+    end
 
     # Process messages linearly - they're already processed and paired
     session[:messages].each_with_index do |message, index|
@@ -1115,8 +1165,10 @@ class ClaudeConversationExporter
                    when 'assistant'
                      "## 🤖 Assistant"
                    when 'assistant_thinking'
+                     return [] if @clean
                      "## 🤖💭 Assistant"
                    when 'system'
+                     return [] if @clean
                      "## ⚙️ System"
                    end
 
@@ -1133,15 +1185,19 @@ class ClaudeConversationExporter
 
       lines << role_header
 
-      # Add message ID as HTML comment if available
-      if message[:message_id]
-        lines << "<!-- #{message[:message_id]} -->"
+      unless @clean
+        # Add message ID as HTML comment if available
+        if message[:message_id]
+          lines << "<!-- #{message[:message_id]} -->"
+        end
       end
 
       lines << ""
     end
 
-    lines << message[:content]
+    content = message[:content]
+    content = content.gsub(/\A[[:space:] ]+/, '') if @clean
+    lines << content
     lines << ""
 
     lines

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ccexport
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Marc Heiligers
@@ -55,8 +55,8 @@ files:
 - LICENSE
 - README.md
 - Rakefile
+- TODO.md
 - bin/ccexport
-- ccexport.gemspec
 - exe/ccexport
 - lib/assets/prism-bash.js
 - lib/assets/prism-json.js
@@ -67,6 +67,7 @@ files:
 - lib/assets/prism.css
 - lib/assets/prism.js
 - lib/ccexport.rb
+- lib/ccexport/cli.rb
 - lib/ccexport/version.rb
 - lib/claude_conversation_exporter.rb
 - lib/markdown_code_block_parser.rb

data/ccexport.gemspec

@@ -1,49 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "lib/ccexport/version"
-
-Gem::Specification.new do |spec|
-  spec.name = "ccexport"
-  spec.version = CcExport::VERSION
-  spec.authors = ["Marc Heiligers"]
-  spec.email = ["marc@silvermerc.net"]
-
-  spec.summary = "Export and preview Claude Code conversations with syntax highlighting"
-  spec.description = <<~DESC
-    A Ruby tool to export Claude Code conversations from JSONL session files 
-    into beautifully formatted Markdown and HTML files with syntax highlighting, 
-    secret detection, and multiple template options.
-  DESC
-  spec.homepage = "https://github.com/marcheiligers/ccexport"
-  spec.license = "MIT"
-  spec.required_ruby_version = ">= 3.0.0"
-
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "#{spec.homepage}.git"
-  spec.metadata["changelog_uri"] = "#{spec.homepage}/blob/main/CHANGELOG.md"
-
-  # Specify which files should be added to the gem when it is released.
-  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files = Dir.chdir(__dir__) do
-    `git ls-files -z`.split("\x0").reject do |f|
-      (File.expand_path(f) == __FILE__) ||
-        f.start_with?(*%w[bin/fetch_secrets_patterns spec/ VIBE claude-conversations/ debug_compacted.rb discover_structure.out discover_structure.rb generate_vibe_samples]) ||
-        f.end_with?('.gem')
-    end
-  end
-  spec.bindir = "exe"
-  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-
-  # Runtime dependencies
-  spec.add_dependency "json", "~> 2.0"
-
-  # Development dependencies
-  spec.add_development_dependency "rspec", "~> 3.12"
-
-  # Specify the minimum version of RubyGems required
-  spec.required_rubygems_version = ">= 1.8.11"
-
-  # For more information and examples about making a new gem, check out our
-  # guide at: https://bundler.io/guides/creating_gem.html
-end