appydave-tools 0.77.7 → 0.79.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cdcce7ddc1828ec8a28fcda70c442f1786443a9e3d04cbdf0a5f03b223f1ce8f
-  data.tar.gz: e419a736811babee9b523fa39cec97e219a903e388b140d4c3140757c15587c0
+  metadata.gz: ec01667ec40e9b0b051f2e834800cd458c736f27107df033ddebeaf7de413823
+  data.tar.gz: 6627f68aefaf25f40cd7d55ba87e8470bd8e5c5a99146927424149b84a31b3b6
 SHA512:
-  metadata.gz: 14de60fca8cc46a8fbe74bb1033ce5d451e1770f22693f7ba641c3f82e95b1dbacec821ad72bd8034c702b268e8673bd7d66ba02c57af25c5c9f9eef61d61d8c
-  data.tar.gz: b8973bb5408519c418c01632b09d40060d18195e7dbd14d8f1e17759ff55f0e367492a65728bf09e372e18d48010997becd26d6b140b7125ae9db39422d1a3da
+  metadata.gz: 8e745ed73fc0f812a6275edb827df2901e5eb0b41c060b4ac68fdc27c9eff750b60b84d2244e21f2b6afb2cda98eacacc3895b6c82502673162202cb31075ddb
+  data.tar.gz: 1814d3250ecf2aebf1ccb9cf50e117fc7b9f220334c263b5b1677336848db1cd7e37f9b684df2903aba96ecc69bbad96368c1acc87fbd6addfed4086eeffe00a

data/CHANGELOG.md

@@ -1,3 +1,22 @@
+# [0.78.0](https://github.com/appydave/appydave-tools/compare/v0.77.7...v0.78.0) (2026-04-03)
+
+
+### Bug Fixes
+
+* resolve rubocop block length violation in llm_context CLI ([305b65a](https://github.com/appydave/appydave-tools/commit/305b65aca92204b877ed25841a8041e9c5a08683))
+
+
+### Features
+
+* update gpt_gatherer to llm_gatherer ([acfbf1c](https://github.com/appydave/appydave-tools/commit/acfbf1c09d40b45d2ca211d5f3921af1127f068c))
+
+## [0.77.7](https://github.com/appydave/appydave-tools/compare/v0.77.6...v0.77.7) (2026-03-20)
+
+
+### Bug Fixes
+
+* parallelize git and S3 status checks in dam list (B007) ([5a6fab1](https://github.com/appydave/appydave-tools/commit/5a6fab1a9a01fda20b81315b640464e393dc1540))
+
 ## [0.77.6](https://github.com/appydave/appydave-tools/compare/v0.77.5...v0.77.6) (2026-03-20)
 
 

data/CLAUDE.md

@@ -27,6 +27,8 @@ Two-phase validation for the 75-commit DAM enhancement sprint (9e49668 → 4228b
 - **Shareable individually** - Tools can be featured in standalone videos
 - **Language flexible** - Currently Ruby, could be rewritten if needed
 
+**System context**: See [CONTEXT.md](CONTEXT.md) for purpose, domain concepts, design rationale, and scope boundaries.
+
 ## Documentation Discovery Protocol
 
 **CRITICAL: When user asks about recent changes, work completed, or project history:**
@@ -162,7 +164,7 @@ bin/console         # Interactive Ruby console for experimentation
 
 | Command | Gem Command | Description | Status |
 |---------|-------------|-------------|--------|
-| **GPT Context** | `gpt_context` | Collect project files for AI context | ⭐ PRIMARY |
+| **LLM Context** | `llm_context` | Collect project files for AI context | ⭐ PRIMARY |
 | **YouTube Manager** | `youtube_manager` | CRUD operations on YouTube video metadata | ✅ ACTIVE |
 | **Subtitle Processor** | `subtitle_processor` | Transform SRT files (clean/merge) | ✅ ACTIVE |
 | **DAM (Digital Asset Management)** | `vat` | Multi-tenant video project storage orchestration | ✅ ACTIVE |
@@ -173,30 +175,33 @@ bin/console         # Interactive Ruby console for experimentation
 
 ---
 
-#### 1. GPT Context Gatherer (`bin/gpt_context.rb`) ⭐ PRIMARY TOOL
+#### 1. LLM Context Gatherer (`bin/llm_context.rb`) ⭐ PRIMARY TOOL
 Collect and organize project files for AI context:
 
 ```bash
 # Basic usage - gather files with debug output and file output
-bin/gpt_context.rb -i '**/*.rb' -e 'spec/**/*' -d -o context.txt
+bin/llm_context.rb -i '**/*.rb' -e 'spec/**/*' -d -o context.txt
 
 # Multiple formats and patterns
-bin/gpt_context.rb -i 'lib/**/*.rb' -i 'bin/**/*.rb' -f tree,content -d
+bin/llm_context.rb -i 'lib/**/*.rb' -i 'bin/**/*.rb' -f tree,content -d
+
+# Save to tempfile, copy path to clipboard
+bin/llm_context.rb -i '**/*.rb' -o temp
 
 # Advanced web project filtering
-bin/gpt_context.rb -i 'apps/**/*.ts' -i 'apps/**/*.tsx' -e '**/node_modules/**/*' -e '**/_generated/**/*' -d -f tree -o typescript.txt
+bin/llm_context.rb -i 'apps/**/*.ts' -i 'apps/**/*.tsx' -e '**/node_modules/**/*' -e '**/_generated/**/*' -d -f tree -o typescript.txt
 
 # Tree view only for project structure
-bin/gpt_context.rb -i '**/*' -e '**/node_modules/**/*' -e '.git/**/*' -f tree -d
+bin/llm_context.rb -i '**/*' -e '**/node_modules/**/*' -e '.git/**/*' -f tree -d
 
 # Line-limited content gathering
-bin/gpt_context.rb -i '**/*.rb' -l 20 -f content -d
+bin/llm_context.rb -i '**/*.rb' -l 20 -f content -d
 
 # Multiple output targets
-bin/gpt_context.rb -i 'docs/**/*' -f tree,content -o clipboard -o docs-context.txt
+bin/llm_context.rb -i 'docs/**/*' -f tree,content -o clipboard -o docs-context.txt
 ```
 
-See detailed usage guide: [docs/usage/gpt-context.md](./docs/usage/gpt-context.md)
+See detailed usage guide: [docs/usage/llm-context.md](./docs/usage/llm-context.md)
 
 #### 2. YouTube Manager (`bin/youtube_manager.rb`)
 Manage YouTube video metadata via YouTube API:

data/CONTEXT.md

@@ -0,0 +1,44 @@
+---
+generated: 2026-04-03
+generator: system-context
+status: snapshot
+sources:
+  - README.md
+  - appydave-tools.gemspec
+  - lib/appydave/tools.rb
+  - lib/appydave/tools/dam/brand_resolver.rb
+  - lib/appydave/tools/dam/project_resolver.rb
+  - lib/appydave/tools/jump/commands/generate.rb
+  - docs/dam/batch-s3-listing-requirements.md
+  - CHANGELOG.md (versions 0.76.0-0.77.7)
+regenerate: "Run /appydave:system-context in the repo root"
+---
+
+# AppyDave Tools — System Context
+
+## Purpose
+Eliminate repetitive manual tasks from YouTube content creation workflows by bundling single-purpose CLI utilities that operate independently on video projects, metadata, and assets.
+
+## Domain Concepts
+- **Brand** — A business entity that owns video projects (AppyDave, VOZ, SupportSignal, etc.). Shortcuts (ad, joy, ss) resolve to brand keys (appydave, beauty-and-joy, supportsignal) in configs.
+- **Project** — A discrete video deliverable. Named by pattern: FliVideo uses short codes (b65 → expands to b65-guy-monroe-marketing-plan), Storyline uses full names (boy-baker). Projects contain assets, metadata, and source files.
+- **Digital Asset Management (DAM)** — Hybrid 3-tier storage: local working copies → S3 staging for collaboration (90-day lifecycle) → SSD archive for long-term cold storage. Orchestrates file sync and lifecycle across tiers.
+- **Project Naming Patterns** — FliVideo: `b<num>` (short) expands to `b<num>-*` full name. Patterns like `b6*` match b60-b69. Storyline uses exact full names (no expansion).
+- **Configuration-driven Architecture** — JSON configs (settings, channels, brands) stored in `~/.config/appydave/` per developer; secrets (.env) gitignored. Enables team collaboration: shared structure, per-dev customization.
+- **Multi-channel YouTube Management** — Handles multiple YouTube channels (each with code, name, handle, locations). Single tool manages metadata updates across channels.
+
+## Design Decisions
+- **Single consolidated repository** — instead of separate gems per tool. Reduces maintenance overhead, enables code reuse, allows individual tools to be featured in standalone tutorials.
+- **Single-purpose tools that operate independently** — each CLI does one thing (llm_context, youtube_manager, dam, etc.). Prevents feature creep, keeps coupling low, enables composition.
+- **Configuration as data** — JSON files enable team sharing of project structure + team-specific path customization in .env. Separates secrets (API keys) from configuration (paths, channels).
+- **Hybrid storage lifecycle** — S3 for short-term collaboration, SSD for archive. Balances cost (S3 pay-per-access), availability (local for daily work), and durability (SSD backup).
+- **Brand/Project resolution layer** — BrandResolver + ProjectResolver decouple CLI input (shortcuts like ad, b65) from system state (config keys, full paths). Users type short codes; system maps to canonical names.
+- **Parallel status checking** — `dam list <brand> --s3` parallelizes git and S3 status checks instead of N sequential API calls. Reduces list latency from 3-5s to <1s.
+
+## Scope Limits
+- Does NOT edit video files directly — only manages metadata, assets, and file organization. Video editing remains in post-production tools (Premiere, DaVinci, etc.).
+- Does NOT provide local playback or streaming — focuses on storage, sync, and metadata. Video playback via external players or YouTube.
+- Does NOT implement YouTube OAuth UI — wraps Google's authentication library. OAuth token generation handled by google-api-client flows, not custom UI.
+- Does NOT manage individual files in DAM — operates on whole project directories as atomic units. Granular file operations are external (rsync, direct S3 CLI).
+- Does NOT provide IDE integration for Jump tool — generates shell aliases and help text. IDE navigation handled by native IDE shortcuts or external plugins.
+- Does NOT handle video versioning or branching — DAM is a flat archive. Version control (git) handles project versioning separately from media storage.

data/README.md

@@ -85,7 +85,7 @@ OPENAI_ACCESS_TOKEN=sk-your-actual-api-key
 
 ## The Tools
 
-### 🤖 GPT Context Gatherer
+### 🤖 LLM Context Gatherer
 
 **The problem:** AI assistants need context about your code, but copying files is tedious.
 
@@ -93,18 +93,21 @@ OPENAI_ACCESS_TOKEN=sk-your-actual-api-key
 
 ```bash
 # Gather all Ruby files, skip tests, save to clipboard
-gpt_context -i '**/*.rb' -e 'spec/**/*' -d
+llm_context -i '**/*.rb' -e 'spec/**/*' -d
 
 # Get project structure as a tree
-gpt_context -i '**/*' -f tree -d
+llm_context -i '**/*' -f tree -d
+
+# Save to tempfile and copy path to clipboard
+llm_context -i '**/*.rb' -o temp
 
 # Multiple file types with custom output
-gpt_context -i 'apps/**/*.ts' -i 'apps/**/*.tsx' -e '**/node_modules/**/*' -o context.txt
+llm_context -i 'apps/**/*.ts' -i 'apps/**/*.tsx' -e '**/node_modules/**/*' -o context.txt
 ```
 
 **Use cases:** Working with ChatGPT, Claude, or any AI assistant on your codebase.
 
-[Full documentation →](./docs/usage/gpt-context.md)
+[Full documentation →](./docs/usage/llm-context.md)
 
 ---
 

data/bin/{gpt_context.rb → llm_context.rb}

@@ -5,32 +5,30 @@
 # https://chatgpt.com/c/670df475-04f4-8002-a758-f5711bf433eb
 
 # Usage:
-#   ./bin/gpt_context.rb -d -i 'lib/openai_101/tools/**/*.rb'
-#   ./bin/gpt_context.rb -d -i 'lib/openai_101/tools/**/*' -e 'node_modules/**/*' -e 'package-lock.json' -e 'lib/openai_101/tools/prompts/*.txt'
+#   ./bin/llm_context.rb -d -i 'lib/openai_101/tools/**/*.rb'
+#   ./bin/llm_context.rb -d -i 'lib/openai_101/tools/**/*' -e 'node_modules/**/*' -e 'package-lock.json' -e 'lib/openai_101/tools/prompts/*.txt'
 #
-#   Get GPT Context Gatherer code
-#   ./bin/gpt_context.rb -i 'bin/**/*gather*.rb' -i 'lib/openai_101/tools/**/*gather*.rb'
+#   Get LLM Context Gatherer code
+#   ./bin/llm_context.rb -i 'bin/**/*gather*.rb' -i 'lib/openai_101/tools/**/*gather*.rb'
 $LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
 
 require 'appydave/tools'
 
-options = Appydave::Tools::GptContext::Options.new(
-  working_directory: nil
-)
-
-OptionParser.new do |opts|
-  opts.banner = <<~BANNER
-    GPT Context Gatherer - Collect project files for AI context
+def build_banner
+  <<~BANNER
+    LLM Context Gatherer - Collect project files for AI context
 
     SYNOPSIS
-        gpt_context [options]
+        llm_context [options]
 
     DESCRIPTION
         Collects and packages codebase files for AI assistant context.
         Outputs to clipboard (default), file, or stdout.
 
   BANNER
+end
 
+def setup_options(opts, options)
   opts.separator 'OPTIONS'
   opts.separator ''
 
@@ -69,7 +67,7 @@ OptionParser.new do |opts|
   end
 
   opts.on('-o', '--output TARGET',
-          'Output target: clipboard, filename, or stdout',
+          'Output target: clipboard, temp, filename, or stdout',
           'Default: clipboard. Repeatable for multiple targets.') do |target|
     options.output_target << target
   end
@@ -83,6 +81,12 @@ OptionParser.new do |opts|
     options.show_tokens = true
   end
 
+  opts.on('--stdin', 'Read file paths from stdin (one per line) instead of using patterns') do
+    options.stdin = true
+  end
+end
+
+def setup_help_sections(opts)
   opts.separator ''
   opts.separator 'OUTPUT FORMATS'
   opts.separator '    tree     - Directory tree structure'
@@ -91,22 +95,39 @@ OptionParser.new do |opts|
   opts.separator '    aider    - Aider CLI command format (requires -p)'
   opts.separator '    files    - File paths only'
   opts.separator ''
+  opts.separator 'OUTPUT TARGETS'
+  opts.separator '    clipboard - Copy to system clipboard (default)'
+  opts.separator '    temp      - Write to system temp dir, copy path to clipboard'
+  opts.separator '    filename  - Write to specified file path'
+  opts.separator ''
+  opts.separator 'INPUT MODES'
+  opts.separator '    Patterns (default): -i <glob> and -e <exclude_glob>'
+  opts.separator '    Stdin:             --stdin (read file paths from stdin, one per line)'
+  opts.separator ''
   opts.separator 'EXAMPLES'
   opts.separator '    # Gather Ruby library code for AI context'
-  opts.separator "    gpt_context -i 'lib/**/*.rb' -e 'spec/**/*' -d"
+  opts.separator "    llm_context -i 'lib/**/*.rb' -e 'spec/**/*' -d"
   opts.separator ''
   opts.separator '    # Project structure overview'
-  opts.separator "    gpt_context -i '**/*' -f tree -e 'node_modules/**/*'"
+  opts.separator "    llm_context -i '**/*' -f tree -e 'node_modules/**/*'"
   opts.separator ''
   opts.separator '    # Save to file with tree and content'
-  opts.separator "    gpt_context -i 'src/**/*.ts' -f tree,content -o context.txt"
+  opts.separator "    llm_context -i 'src/**/*.ts' -f tree,content -o context.txt"
+  opts.separator ''
+  opts.separator '    # Write to system temp dir and copy path to clipboard'
+  opts.separator "    llm_context -i 'lib/**/*.rb' -o temp"
+  opts.separator ''
+  opts.separator '    # Read file paths from stdin'
+  opts.separator "    find lib -name '*.rb' | llm_context --stdin -o temp"
   opts.separator ''
   opts.separator '    # Generate aider command'
-  opts.separator "    gpt_context -i 'lib/**/*.rb' -f aider -p 'Add logging'"
+  opts.separator "    llm_context -i 'lib/**/*.rb' -f aider -p 'Add logging'"
   opts.separator ''
+end
 
+def setup_version_and_help(opts)
   opts.on('-v', '--version', 'Show version') do
-    puts "gpt_context version #{Appydave::Tools::VERSION}"
+    puts "llm_context version #{Appydave::Tools::VERSION}"
     exit
   end
 
@@ -114,12 +135,32 @@ OptionParser.new do |opts|
     puts opts
     exit
   end
-end.parse!
+end
+
+# Main execution
+options = Appydave::Tools::LlmContext::Options.new(
+  working_directory: nil
+)
+
+parser = OptionParser.new do |opts|
+  opts.banner = build_banner
+  setup_options(opts, options)
+  setup_help_sections(opts)
+  setup_version_and_help(opts)
+end
+
+parser.parse!
+
+# Handle stdin file paths
+if options.stdin
+  options.file_paths = $stdin.readlines.map(&:chomp).reject(&:empty?)
+  options.working_directory = Dir.pwd unless options.working_directory
+end
 
-if options.include_patterns.empty? && options.exclude_patterns.empty?
+if options.include_patterns.empty? && options.exclude_patterns.empty? && options.file_paths.empty?
   script_name = File.basename($PROGRAM_NAME, File.extname($PROGRAM_NAME))
 
-  puts 'No options provided to GPT Context. Please specify patterns to include or exclude.'
+  puts 'No options provided to LLM Context. Please specify patterns to include or exclude, or use --stdin.'
   puts "For help, run: #{script_name} --help"
   exit
 end
@@ -133,7 +174,7 @@ pp options if options.debug == 'params'
 
 options.working_directory ||= Dir.pwd
 
-gatherer = Appydave::Tools::GptContext::FileCollector.new(options)
+gatherer = Appydave::Tools::LlmContext::FileCollector.new(options)
 content = gatherer.build
 
 if options.show_tokens
@@ -159,7 +200,7 @@ if %w[info debug].include?(options.debug)
   puts '-' * 80
 end
 
-output_handler = Appydave::Tools::GptContext::OutputHandler.new(content, options)
+output_handler = Appydave::Tools::LlmContext::OutputHandler.new(content, options)
 output_handler.execute
 
 pp options if options.debug == 'debug'

data/docs/planning/BACKLOG.md

@@ -1,16 +1,13 @@
 # Project Backlog — AppyDave Tools
 
-**Last updated**: 2026-03-20 (s3-operations-split campaign complete)
-**Total**: 41 | Pending: 3 | Done: 37 | Deferred: 0 | Rejected: 0
+**Last updated**: 2026-03-20 (B007 complete)
+**Total**: 41 | Pending: 2 | Done: 38 | Deferred: 0 | Rejected: 0
 
 ---
 
 ## Pending
 
 ### Medium Priority
-- [ ] B001 — FR-1: GPT Context token counting | Priority: medium
-- [ ] B012 — Arch: add integration tests for brand resolution end-to-end | Priority: medium
-- [ ] B007 — Performance: parallel git/S3 status checks for dam list | Priority: low (unblocked — B020 complete)
 - [ ] B008 — Performance: cache git/S3 status with 5-min TTL | Priority: low
 - [ ] B040 — Fix: ProjectResolver.resolve raises RuntimeError not typed exception (found in B012) | Priority: low
 
@@ -55,6 +52,7 @@
 - [x] B010 — UX: terminal-width-aware separator lines + truncate_path in project_listing | Completed: batch-a-features (2026-03-20), v0.77.0
 - [x] B009 — UX: progress indicators for dam S3 operations (upload, download, status, archive, sync-ssd) | Completed: batch-a-features (2026-03-20), v0.77.1
 - [x] B020 — Arch: split S3Operations into S3Base + S3Uploader + S3Downloader + S3StatusChecker + S3Archiver; S3Operations thin facade | Completed: s3-operations-split (2026-03-20), v0.77.6
+- [x] B007 — Performance: parallel git/S3 status checks for dam list (Thread.new per project + per check) | Completed: 2026-03-20, v0.77.7
 
 ---
 

data/exe/{gpt_context → llm_context}

@@ -3,4 +3,4 @@
 
 require 'appydave/tools'
 
-load File.expand_path('../bin/gpt_context.rb', __dir__)
+load File.expand_path('../bin/llm_context.rb', __dir__)

data/lib/appydave/tools/jump/commands/generate.rb

@@ -358,6 +358,7 @@ module Appydave
 
           def write_or_return(content, path, default_filename)
             if path
+              path = File.expand_path(path)
               backup_result = backup_existing_file(path)
               FileUtils.mkdir_p(File.dirname(path))
               File.write(path, content)

data/lib/appydave/tools/{gpt_context → llm_context}/_doc.md

@@ -1,4 +1,4 @@
-# GPT Context Gather
+# LLM Context Gatherer
 
 [ChatGPT conversation](https://chatgpt.com/c/efba7b3c-21e7-415c-97eb-92994c3e49fc)
 

data/lib/appydave/tools/{gpt_context → llm_context}/file_collector.rb

@@ -2,8 +2,8 @@
 
 module Appydave
   module Tools
-    # Build GPT context from various sources
-    module GptContext
+    # Build LLM context from various sources
+    module LlmContext
       # Gathers file names and content based on include and exclude patterns
       class FileCollector
         def initialize(options)
@@ -13,6 +13,7 @@ module Appydave
           @format = options.format
           @working_directory = File.expand_path(options.working_directory)
           @line_limit = options.line_limit
+          @file_paths = options.file_paths
         end
 
         def build
@@ -23,6 +24,22 @@ module Appydave
 
         private
 
+        def collect_files
+          if @file_paths.any?
+            # Use file paths directly (from stdin)
+            @file_paths.reject { |f| excluded?(f) || File.directory?(f) }
+          else
+            # Use glob patterns
+            files = []
+            @include_patterns.each do |pattern|
+              Dir.glob(pattern).each do |file_path|
+                files << file_path unless excluded?(file_path) || File.directory?(file_path)
+              end
+            end
+            files
+          end
+        end
+
         def build_formats
           @format.split(',').map do |fmt|
             case fmt
@@ -38,13 +55,9 @@ module Appydave
         def build_content
           concatenated_content = []
 
-          @include_patterns.each do |pattern|
-            Dir.glob(pattern).each do |file_path|
-              next if excluded?(file_path) || File.directory?(file_path)
-
-              content = "# file: #{file_path}\n\n#{read_file_content(file_path)}"
-              concatenated_content << content
-            end
+          collect_files.each do |file_path|
+            content = "# file: #{file_path}\n\n#{read_file_content(file_path)}"
+            concatenated_content << content
           end
 
           concatenated_content.join("\n\n")
@@ -60,13 +73,9 @@ module Appydave
         def build_tree
           tree_view = {}
 
-          @include_patterns.each do |pattern|
-            Dir.glob(pattern).each do |file_path|
-              next if excluded?(file_path)
-
-              path_parts = file_path.split('/')
-              insert_into_tree(tree_view, path_parts)
-            end
+          collect_files.each do |file_path|
+            path_parts = file_path.split('/')
+            insert_into_tree(tree_view, path_parts)
           end
 
           build_tree_pretty(tree_view).rstrip
@@ -96,22 +105,14 @@ module Appydave
             'content' => []
           }
 
-          # Building tree structure in JSON
-          @include_patterns.each do |pattern|
-            Dir.glob(pattern).each do |file_path|
-              next if excluded?(file_path)
+          collect_files.each do |file_path|
+            path_parts = file_path.split('/')
+            insert_into_tree(json_output['tree'], path_parts)
 
-              path_parts = file_path.split('/')
-              insert_into_tree(json_output['tree'], path_parts)
-
-              # Building content structure in JSON
-              next if excluded?(file_path) || File.directory?(file_path)
-
-              json_output['content'] << {
-                'file' => file_path,
-                'content' => read_file_content(file_path)
-              }
-            end
+            json_output['content'] << {
+              'file' => file_path,
+              'content' => read_file_content(file_path)
+            }
           end
 
           JSON.pretty_generate(json_output)
@@ -120,15 +121,7 @@ module Appydave
         def build_aider
           return '' unless @options.prompt
 
-          files = []
-          @include_patterns.each do |pattern|
-            Dir.glob(pattern).each do |file_path|
-              next if excluded?(file_path) || File.directory?(file_path)
-
-              files << file_path
-            end
-          end
-
+          files = collect_files
           "aider --message \"#{@options.prompt}\" #{files.join(' ')}"
         end
 

data/lib/appydave/tools/{gpt_context → llm_context}/options.rb

@@ -2,7 +2,7 @@
 
 module Appydave
   module Tools
-    module GptContext
+    module LlmContext
       # Struct with keyword_init: true to allow named parameters
       Options = Struct.new(
         :include_patterns,
@@ -14,6 +14,8 @@ module Appydave
         :working_directory,
         :prompt,
         :show_tokens,
+        :file_paths,
+        :stdin,
         keyword_init: true
       ) do
         def initialize(**args)
@@ -25,6 +27,8 @@ module Appydave
           self.output_target ||= []
           self.prompt ||= nil
           self.show_tokens ||= false
+          self.file_paths ||= []
+          self.stdin ||= false
         end
       end
     end

data/lib/appydave/tools/{gpt_context → llm_context}/output_handler.rb

@@ -2,7 +2,7 @@
 
 module Appydave
   module Tools
-    module GptContext
+    module LlmContext
       # OutputHandler is responsible for writing the output to the desired target
       class OutputHandler
         def initialize(content, options)
@@ -16,6 +16,8 @@ module Appydave
             case target
             when 'clipboard'
               Clipboard.copy(@content)
+            when 'temp'
+              write_to_temp
             when /^.+$/
               write_to_file(target)
             end
@@ -30,6 +32,20 @@ module Appydave
           resolved_path = Pathname.new(target).absolute? ? target : File.join(working_directory, target)
           File.write(resolved_path, content)
         end
+
+        def write_to_temp
+          # Create in system temp directory with descriptive name
+          tmp_dir = Dir.tmpdir
+          timestamp = Time.now.strftime('%Y%m%d-%H%M%S-%N')[0..18] # millisecond precision
+          file_path = File.join(tmp_dir, "llm_context-#{timestamp}.txt")
+
+          # Write content to file
+          File.write(file_path, @content)
+
+          # Copy path to clipboard
+          Clipboard.copy(file_path)
+          warn "Context saved to: #{file_path}"
+        end
       end
     end
   end

data/lib/appydave/tools/version.rb

@@ -2,6 +2,6 @@
 
 module Appydave
   module Tools
-    VERSION = '0.77.7'
+    VERSION = '0.79.0'
   end
 end

data/lib/appydave/tools.rb

@@ -33,9 +33,9 @@ require 'appydave/tools/cli_actions/prompt_completion_action'
 require 'appydave/tools/cli_actions/get_video_action'
 require 'appydave/tools/cli_actions/update_video_action'
 
-require 'appydave/tools/gpt_context/options'
-require 'appydave/tools/gpt_context/file_collector'
-require 'appydave/tools/gpt_context/output_handler'
+require 'appydave/tools/llm_context/options'
+require 'appydave/tools/llm_context/file_collector'
+require 'appydave/tools/llm_context/output_handler'
 
 require 'appydave/tools/configuration/openai'
 require 'appydave/tools/configuration/configurable'

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appydave-tools",
-  "version": "0.77.7",
+  "version": "0.79.0",
   "description": "AppyDave YouTube Automation Tools",
   "scripts": {
     "release": "semantic-release"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: appydave-tools
 version: !ruby/object:Gem::Version
-  version: 0.77.7
+  version: 0.79.0
 platform: ruby
 authors:
 - David Cruwys
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-03-20 00:00:00.000000000 Z
+date: 2026-04-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
@@ -187,8 +187,8 @@ email:
 executables:
 - ad_config
 - dam
-- gpt_context
 - jump
+- llm_context
 - prompt_tools
 - subtitle_processor
 - youtube_automation
@@ -197,7 +197,6 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- ".DS_Store"
 - ".builders/_.rb"
 - ".builders/boot.rb"
 - ".builders/generators/01-bootstrap.rb"
@@ -214,6 +213,7 @@ files:
 - CHANGELOG.md
 - CLAUDE.md
 - CODE_OF_CONDUCT.md
+- CONTEXT.md
 - Gemfile
 - Guardfile
 - LICENSE.txt
@@ -225,8 +225,8 @@ files:
 - bin/console
 - bin/dam
 - bin/generate_manifest.rb
-- bin/gpt_context.rb
 - bin/jump.rb
+- bin/llm_context.rb
 - bin/move_images.rb
 - bin/prompt_tools.rb
 - bin/setup
@@ -335,8 +335,8 @@ files:
 - docs/uat/FR-3-jump-location-tool.md
 - exe/ad_config
 - exe/dam
-- exe/gpt_context
 - exe/jump
+- exe/llm_context
 - exe/prompt_tools
 - exe/subtitle_processor
 - exe/youtube_automation
@@ -387,10 +387,6 @@ files:
 - lib/appydave/tools/dam/status.rb
 - lib/appydave/tools/dam/sync_from_ssd.rb
 - lib/appydave/tools/debuggable.rb
-- lib/appydave/tools/gpt_context/_doc.md
-- lib/appydave/tools/gpt_context/file_collector.rb
-- lib/appydave/tools/gpt_context/options.rb
-- lib/appydave/tools/gpt_context/output_handler.rb
 - lib/appydave/tools/jump/cli.rb
 - lib/appydave/tools/jump/commands/add.rb
 - lib/appydave/tools/jump/commands/base.rb
@@ -409,6 +405,10 @@ files:
 - lib/appydave/tools/jump/search.rb
 - lib/appydave/tools/llm/models/llm_info.rb
 - lib/appydave/tools/llm/openai_completion.rb
+- lib/appydave/tools/llm_context/_doc.md
+- lib/appydave/tools/llm_context/file_collector.rb
+- lib/appydave/tools/llm_context/options.rb
+- lib/appydave/tools/llm_context/output_handler.rb
 - lib/appydave/tools/name_manager/_doc.md
 - lib/appydave/tools/name_manager/project_name.rb
 - lib/appydave/tools/prompt_tools/_doc.md