aia 0.9.24 → 0.10.2

data/docs/guides/image-generation.md

@@ -11,7 +11,7 @@ AIA supports AI-powered image generation through various models, enabling you to
 ### Image Model Capabilities
 ```bash
 # Check available image generation models
-aia --available_models text_to_image
+aia --available-models text_to_image
 
 # Example output:
 # - dall-e-3 (openai) text to image
@@ -26,26 +26,26 @@ aia --available_models text_to_image
 aia --model dall-e-3 "A serene mountain lake at sunset"
 
 # Generate with specific size
-aia --model dall-e-3 --image_size 1024x1024 "Modern office workspace"
+aia --model dall-e-3 --image-size 1024x1024 "Modern office workspace"
 
 # Generate with quality settings
-aia --model dall-e-3 --image_quality hd "Professional headshot"
+aia --model dall-e-3 --image-quality hd "Professional headshot"
 ```
 
 ### Image Configuration Options
 
-#### Image Size (`--image_size`, `--is`)
+#### Image Size (`--image-size`, `--is`)
 ```bash
 # Square formats
-aia --image_size 1024x1024 "Square image prompt"
+aia --image-size 1024x1024 "Square image prompt"
 aia --is 512x512 "Smaller square image"
 
 # Landscape formats  
-aia --image_size 1792x1024 "Wide landscape image"
+aia --image-size 1792x1024 "Wide landscape image"
 aia --is 1344x768 "Medium landscape"
 
 # Portrait formats
-aia --image_size 1024x1792 "Tall portrait image"
+aia --image-size 1024x1792 "Tall portrait image"
 aia --is 768x1344 "Medium portrait"
 ```
 
@@ -54,13 +54,13 @@ aia --is 768x1344 "Medium portrait"
 - Landscape: `1792x1024`, `1344x768`
 - Portrait: `1024x1792`, `768x1344`
 
-#### Image Quality (`--image_quality`, `--iq`)
+#### Image Quality (`--image-quality`, `--iq`)
 ```bash
 # Standard quality (faster, less expensive)
-aia --image_quality standard "Quick concept image"
+aia --image-quality standard "Quick concept image"
 
 # HD quality (better detail, more expensive)  
-aia --image_quality hd "High-quality marketing image"
+aia --image-quality hd "High-quality marketing image"
 aia --iq hd "Detailed technical diagram"
 ```
 
@@ -68,13 +68,13 @@ aia --iq hd "Detailed technical diagram"
 - `standard`: Good quality, faster generation, lower cost
 - `hd`: Enhanced detail and resolution, slower, higher cost
 
-#### Image Style (`--style`, `--image_style`)
+#### Image Style (`--style`, `--image-style`)
 ```bash
 # Vivid style (hyper-real, dramatic colors)
-aia --image_style vivid "Dramatic sunset over city skyline"
+aia --image-style vivid "Dramatic sunset over city skyline"
 
 # Natural style (more natural, less stylized)
-aia --image_style natural "Realistic portrait of a person reading"
+aia --image-style natural "Realistic portrait of a person reading"
 aia --style natural "Documentary-style photograph"
 ```
 
@@ -342,30 +342,30 @@ aia --model dall-e-3 "Centered composition, symmetrical balance, rule of thirds,
 #### Resolution and Size Selection
 ```bash
 # Choose size based on use case
-aia --image_size 1792x1024 "Website hero image"      # Landscape
-aia --image_size 1024x1792 "Mobile app screenshot"   # Portrait
-aia --image_size 1024x1024 "Social media post"       # Square
+aia --image-size 1792x1024 "Website hero image"      # Landscape
+aia --image-size 1024x1792 "Mobile app screenshot"   # Portrait
+aia --image-size 1024x1024 "Social media post"       # Square
 ```
 
 #### Quality vs. Cost Balance
 ```bash
 # Standard for concepts/drafts
-aia --image_quality standard "Initial concept image"
+aia --image-quality standard "Initial concept image"
 
 # HD for final/published images
-aia --image_quality hd "Final marketing image"
+aia --image-quality hd "Final marketing image"
 ```
 
 ### Iterative Refinement
 ```bash
 # Generate initial concept
-aia --model dall-e-3 --out_file concept_v1.png "Modern kitchen design"
+aia --model dall-e-3 --output concept_v1.png "Modern kitchen design"
 
 # Refine based on results
-aia --model dall-e-3 --out_file concept_v2.png "Modern kitchen with marble countertops, pendant lighting, minimalist cabinets"
+aia --model dall-e-3 --output concept_v2.png "Modern kitchen with marble countertops, pendant lighting, minimalist cabinets"
 
 # Final version with specific details
-aia --model dall-e-3 --image_quality hd --out_file final_kitchen.png "Ultra-modern kitchen with white marble waterfall countertops, brass pendant lights, handleless cabinets, large island, professional photography"
+aia --model dall-e-3 --image-quality hd --output final_kitchen.png "Ultra-modern kitchen with white marble waterfall countertops, brass pendant lights, handleless cabinets, large island, professional photography"
 ```
 
 ## Troubleshooting Image Generation
@@ -399,7 +399,7 @@ aia --model dall-e-3 "Subject photographed with 50mm lens, f/2.8, natural lighti
 **Solutions**:
 ```bash
 # Specify exact requirements
-aia --model dall-e-3 --image_size 1792x1024 --image_quality hd "Detailed prompt"
+aia --model dall-e-3 --image-size 1792x1024 --image-quality hd "Detailed prompt"
 
 # Match use case to settings
 aia --is 1024x1024 --iq standard "Social media post"  # Standard for social media
@@ -424,10 +424,10 @@ end
 #### Cost Management
 ```bash
 # Use standard quality for iterations
-aia --image_quality standard "Draft version for review"
+aia --image-quality standard "Draft version for review"
 
 # Use HD only for finals
-aia --image_quality hd "Final approved concept"
+aia --image-quality hd "Final approved concept"
 ```
 
 ## Integration Examples

data/docs/guides/local-models.md

@@ -209,7 +209,7 @@ aia --model ollama/llama3.2,ollama/mistral,gpt-4 --consensus decision_prompt
 
 ```bash
 # 1. Process with local model (private)
-aia --model ollama/llama3.2 --out_file draft.md sensitive_data.txt
+aia --model ollama/llama3.2 --output draft.md sensitive_data.txt
 
 # 2. Review and sanitize draft.md manually
 
@@ -222,7 +222,7 @@ aia --model gpt-4 --include draft.md final_output
 ```bash
 # Bulk tasks with local model
 for i in {1..1000}; do
-  aia --model ollama/mistral --out_file "result_$i.md" process "input_$i.txt"
+  aia --model ollama/mistral --output "result_$i.md" process "input_$i.txt"
 done
 
 # No API costs!

data/docs/guides/models.md

@@ -7,20 +7,20 @@ AIA supports multiple AI models through the RubyLLM gem, allowing you to choose
 ### List All Models
 ```bash
 # Show all available models
-aia --available_models
+aia --available-models
 
 # Filter by provider
-aia --available_models openai
-aia --available_models anthropic
-aia --available_models google
+aia --available-models openai
+aia --available-models anthropic
+aia --available-models google
 
 # Filter by capability
-aia --available_models vision
-aia --available_models function_calling
-aia --available_models text_to_image
+aia --available-models vision
+aia --available-models function_calling
+aia --available-models text_to_image
 
 # Complex filtering
-aia --available_models openai,gpt,4
+aia --available-models openai,gpt,4
 ```
 
 ### Model Information
@@ -167,6 +167,84 @@ Model Details:
 - **Error Handling**: Invalid models are reported but don't prevent valid models from working
 - **Batch Mode Support**: Multi-model responses are properly formatted in output files
 
+### Token Usage and Cost Tracking
+
+One of AIA's most powerful capabilities is real-time tracking of token usage and cost estimates across multiple models. This enables informed decisions about model selection based on both quality and cost.
+
+#### Enabling Token Tracking
+
+```bash
+# Display token usage for each model
+aia my_prompt -m gpt-4o,claude-3-sonnet --tokens
+
+# Include cost estimates (automatically enables --tokens)
+aia my_prompt -m gpt-4o,claude-3-sonnet --cost
+
+# In chat mode with full tracking
+aia --chat -m gpt-4o,claude-3-sonnet,gemini-pro --cost
+```
+
+#### Multi-Model Comparison with Metrics
+
+```bash
+# Compare 3 models with cost tracking
+aia --chat -m gpt-4o,claude-3-5-sonnet,gemini-1.5-pro --cost
+```
+
+**Example Output:**
+```
+You: Explain the CAP theorem and its implications for distributed databases.
+
+from: gpt-4o
+The CAP theorem states that a distributed system can only guarantee two of three properties...
+
+from: claude-3-5-sonnet
+CAP theorem, proposed by Eric Brewer, describes fundamental trade-offs in distributed systems...
+
+from: gemini-1.5-pro
+The CAP theorem is a cornerstone principle in distributed computing that states...
+
+┌─────────────────────────────────────────────────────────────────┐
+│ Model               │ Input Tokens │ Output Tokens │ Cost      │
+├─────────────────────────────────────────────────────────────────┤
+│ gpt-4o              │ 42           │ 287           │ $0.0068   │
+│ claude-3-5-sonnet   │ 42           │ 312           │ $0.0053   │
+│ gemini-1.5-pro      │ 42           │ 298           │ $0.0038   │
+└─────────────────────────────────────────────────────────────────┘
+Total: $0.0159
+```
+
+#### Use Cases for Token/Cost Tracking
+
+| Use Case | Description |
+|----------|-------------|
+| **Budget Management** | Monitor API costs in real-time during development |
+| **Model Evaluation** | Compare quality vs. cost across different providers |
+| **Cost Optimization** | Identify the most cost-effective model for your tasks |
+| **Usage Auditing** | Track token consumption for billing and optimization |
+| **A/B Testing** | Compare model performance with objective metrics |
+
+#### Combining with Consensus Mode
+
+```bash
+# Get consensus response with cost breakdown
+aia my_prompt -m gpt-4o,claude-3-sonnet,gemini-pro --consensus --cost
+
+# The consensus response shows combined metrics:
+# Tokens: input=126 (total), output=892 (consensus + individual)
+# Cost: $0.0189 (all models combined)
+```
+
+#### Environment Variables
+
+```bash
+# Enable token tracking by default
+export AIA_FLAGS__TOKENS=true
+
+# Enable cost tracking by default
+export AIA_FLAGS__COST=true
+```
+
 ### Per-Model Roles
 
 Assign specific roles to each model in multi-model mode to get diverse perspectives on your prompts. Each model receives a prepended role prompt that shapes its perspective.
@@ -431,7 +509,7 @@ aia --model claude-3-haiku code_completion
 
 # Bulk processing
 for file in *.txt; do
-  aia --model gpt-3.5-turbo --out_file "${file%.txt}_processed.md" process_file "$file"
+  aia --model gpt-3.5-turbo --output "${file%.txt}_processed.md" process_file "$file"
 done
 ```
 
@@ -699,7 +777,7 @@ export LMS_API_BASE=http://localhost:1234/v1
 #### Privacy-First Workflow
 ```bash
 # Use local model for sensitive data
-aia --model ollama/llama3.2 --out_file draft.md process_private_data.txt
+aia --model ollama/llama3.2 --output draft.md process_private_data.txt
 
 # Use cloud model for final polish (on sanitized data)
 aia --model gpt-4 --include draft.md refine_output
@@ -709,7 +787,7 @@ aia --model gpt-4 --include draft.md refine_output
 ```bash
 # Bulk processing with local model (free)
 for file in *.txt; do
-  aia --model ollama/mistral --out_file "${file%.txt}_summary.md" summarize "$file"
+  aia --model ollama/mistral --output "${file%.txt}_summary.md" summarize "$file"
 done
 
 # Final review with premium cloud model
@@ -732,10 +810,10 @@ aia --model ollama/llama3.2,lms/qwen-coder,claude-3-sonnet --no-consensus code_r
 #### Model Not Available
 ```bash
 # Check if model exists
-aia --available_models | grep model_name
+aia --available-models | grep model_name
 
 # Try alternative model names
-aia --available_models anthropic
+aia --available-models anthropic
 ```
 
 #### Authentication Errors
@@ -775,10 +853,10 @@ aia --model claude-3-sonnet alternative_processing
 ### Model Switching Workflows
 ```bash
 # Start with fast model for initial processing
-aia --model gpt-3.5-turbo --out_file draft.md initial_analysis data.csv
+aia --model gpt-3.5-turbo --output draft.md initial_analysis data.csv
 
 # Switch to quality model for refinement
-aia --model gpt-4 --include draft.md --out_file final.md refine_analysis
+aia --model gpt-4 --include draft.md --output final.md refine_analysis
 
 # Use specialized model for specific tasks
 aia --model gpt-4-vision --include final.md image_analysis charts/
@@ -803,8 +881,8 @@ puts "Selected #{model} for #{complexity} complexity task"
 ### Model Ensemble Techniques
 ```bash
 # Use different models for different aspects
-aia --model gpt-4 --out_file technical_analysis.md technical_review code.py
-aia --model claude-3-sonnet --out_file style_analysis.md style_review code.py
+aia --model gpt-4 --output technical_analysis.md technical_review code.py
+aia --model claude-3-sonnet --output style_analysis.md style_review code.py
 aia --model gpt-3.5-turbo --include technical_analysis.md --include style_analysis.md synthesize_reviews
 ```
 
@@ -826,7 +904,7 @@ You: //compare "Explain this concept" --models gpt-4,claude-3-sonnet
 ### Pipeline Model Configuration
 ```bash
 # Different models for different pipeline stages
-aia --config_file pipeline_config.yml --pipeline "extract,analyze,report"
+aia --config-file pipeline_config.yml --pipeline "extract,analyze,report"
 
 # pipeline_config.yml
 extract:

data/docs/guides/tools.md

@@ -47,13 +47,13 @@ aia --tools "./tools/,./custom_tools.rb,/shared/tools/" my_prompt
 ### Tool Security
 ```bash
 # Restrict to specific tools
-aia --tools ./tools/ --allowed_tools "file_reader,calculator" my_prompt
+aia --tools ./tools/ --allowed-tools "file_reader,calculator" my_prompt
 
 # Block dangerous tools
-aia --tools ./tools/ --rejected_tools "file_writer,system_admin" my_prompt
+aia --tools ./tools/ --rejected-tools "file_writer,system_admin" my_prompt
 
 # Combine restrictions
-aia --tools ./tools/ --allowed_tools "safe_tools" --rejected_tools "dangerous_tools" my_prompt
+aia --tools ./tools/ --allowed-tools "safe_tools" --rejected-tools "dangerous_tools" my_prompt
 ```
 
 ### Discovering Available Tools
@@ -749,7 +749,7 @@ class DebuggingTool < RubyLLM::Tool
   end
   
   def debug_mode?
-    ENV['AIA_DEBUG'] == 'true'
+    ENV['AIA_FLAGS__DEBUG'] == 'true'
   end
 end
 ```

data/docs/installation.md

@@ -153,7 +153,7 @@ gem install tty-prompt
 ### 1. Check Available Models
 
 ```bash
-aia --available_models
+aia --available-models
 ```
 
 This will show all available AI models.
@@ -191,7 +191,7 @@ This should start an interactive chat session.
 #### "No models available"
 - Check that your API keys are set correctly
 - Verify your internet connection
-- Try: `aia --available_models` to diagnose
+- Try: `aia --available-models` to diagnose
 
 #### "fzf not found" warning
 - Install fzf as described above

data/docs/prompt_management.md

@@ -32,12 +32,12 @@ AIA provides sophisticated prompt management capabilities through the PromptMana
 
 ### Custom Structure
 ```bash
-# Set custom prompts directory
-export AIA_PROMPTS_DIR="/path/to/custom/prompts"
-aia --prompts_dir /path/to/custom/prompts
+# Set custom prompts directory (uses nested naming convention)
+export AIA_PROMPTS__DIR="/path/to/custom/prompts"
+aia --prompts-dir /path/to/custom/prompts
 
 # Use project-specific prompts
-aia --prompts_dir ./project_prompts my_prompt
+aia --prompts-dir ./project_prompts my_prompt
 ```
 
 ## Prompt File Formats
@@ -126,7 +126,7 @@ Please analyze this system information and provide:
 ### Basic Search
 ```bash
 # List all prompts
-aia --prompts_dir ~/.prompts
+aia --prompts-dir ~/.prompts
 
 # Search by pattern
 find ~/.prompts -name "*code*" -type f
@@ -155,7 +155,7 @@ aia --fuzzy development/
 aia --fuzzy roles/
 
 # Search in specific subdirectory
-aia --prompts_dir ~/.prompts/analysis --fuzzy
+aia --prompts-dir ~/.prompts/analysis --fuzzy
 ```
 
 ## Prompt Organization Strategies
@@ -272,7 +272,7 @@ aia --role software_architect system_design
 aia --role code_expert code_review main.py
 
 # Custom roles directory
-aia --roles_prefix personas --role mentor learning_session
+aia --roles-prefix personas --role mentor learning_session
 ```
 
 ### Context Layering
@@ -378,10 +378,10 @@ Enhanced code review with security focus and structured output.
 ```bash
 # Shared team prompts
 git clone git@github.com:team/shared-prompts.git ~/.prompts/shared/
-aia --prompts_dir ~/.prompts/shared/ team_code_review
+aia --prompts-dir ~/.prompts/shared/ team_code_review
 
 # Personal + shared prompts
-export AIA_PROMPTS_DIR="~/.prompts:~/.prompts/shared:./project_prompts"
+export AIA_PROMPTS__DIR="~/.prompts:~/.prompts/shared:./project_prompts"
 ```
 
 ### Prompt Documentation
@@ -450,11 +450,11 @@ end
 ```bash
 # Batch process multiple files
 for file in data/*.csv; do
-  aia batch_analysis_prompt "$file" --out_file "results/$(basename $file .csv)_analysis.md"
+  aia batch_analysis_prompt "$file" --output "results/$(basename $file .csv)_analysis.md"
 done
 
 # Parallel processing
-parallel -j4 aia analysis_prompt {} --out_file {.}_result.md ::: data/*.txt
+parallel -j4 aia analysis_prompt {} --output {.}_result.md ::: data/*.txt
 ```
 
 ## Troubleshooting Prompts

data/docs/security.md

@@ -31,7 +31,7 @@ export OPENAI_API_KEY_FULL="sk-..."          # For full operations
 ### Key Validation and Testing
 ```bash
 # Test API keys safely
-aia --available_models | head -5  # Test without exposing key
+aia --available-models | head -5  # Test without exposing key
 
 # Validate key format before use
 if [[ $OPENAI_API_KEY =~ ^sk-[a-zA-Z0-9]{48}$ ]]; then
@@ -582,8 +582,8 @@ security_response() {
             echo "AIA disabled due to security alert" | mail -s "AIA Security Alert" admin@company.com
             ;;
         "MEDIUM")
-            # Increase logging level
-            export AIA_LOG_LEVEL=debug
+            # Increase logging level (nested config format)
+            export AIA_LOGGER__AIA__LEVEL=debug
             echo "AIA security monitoring increased" | mail -s "AIA Security Notice" admin@company.com
             ;;
         "LOW")

data/docs/workflows-and-pipelines.md

@@ -55,7 +55,7 @@ aia data_prep --next analysis --next report dataset.csv
 aia --pipeline "step1,step2,step3" input.txt
 
 # Pipeline with output files
-aia --pipeline "extract,transform,load" --out_file results.md data.csv
+aia --pipeline "extract,transform,load" --output results.md data.csv
 
 # Pipeline with model specification
 aia --model gpt-4 --pipeline "review,optimize,test" code.py

data/examples/README.md

@@ -10,17 +10,17 @@ An executable prompt is a special type of prompt file that is structured to allo
 
 1. **Shebang Line**: The first line of the prompt indicates how the file should be executed. For instance:
    ```bash
-   #!/usr/bin/env aia run --no-out_file
+   #!/usr/bin/env aia run --no-output
    ```
 
-   This line tells the system to use the `aia` CLI with the `run` prompt ID for execution, while `--no-out_file` indicates that output should be sent to STDOUT instead of being written to a file.
+   This line tells the system to use the `aia` CLI with the `run` prompt ID for execution, while `--no-output` indicates that output should be sent to STDOUT instead of being written to a file.
 
 2. **Content**: Below the shebang line, users can add the prompt content that will be sent to the AI model for processing. This content can use flexible directives and dynamic parameters.
 
 ### Example of an Executable Prompt
 
 ```bash
-#!/usr/bin/env aia run --no-out_file
+#!/usr/bin/env aia run --no-output
 # File: top10
 # Desc: The top 10 cities by population
 
@@ -45,7 +45,7 @@ The `//config` directive is used to modify configuration settings specifically f
 
 ```bash
 //config model = gpt-4
-//config out_file = results.md
+//config output = results.md
 ```
 
 **Example**: You can control the model and output settings dynamically without changing global or default settings.
@@ -94,11 +94,11 @@ When the prompt runs, users will be prompted to provide a value for `MY_TOPIC`,
 Create a script that gives information on the top cities in the USA:
 
 ```bash
-#!/usr/bin/env aia run --no-out_file
+#!/usr/bin/env aia run --no-output
 # File: top10
 # Desc: Retrieves top 10 cities by population
 
-//config out_file=top10_cities.md
+//config output=top10_cities.md
 
 What are the top 10 cities by population in the USA? Summarize what people like about living in each city and include links to their respective Wikipedia pages.
 ```

data/examples/headlines

@@ -1,13 +1,13 @@
-#!/usr/bin/env aia run --no-out_file --exec
+#!/usr/bin/env aia run --no-output --exec
 # NOTE: the --exec option is REQUIRED to run this executable prompt file
 #       This option signals that the contents of this file are to be appended
 #       to the contents of the given prompt ID file.  In this case it is the
 #       "run" prompt ID's text file.
 #
-#       All other AIA options are, well, optional.  The --no-out_file is
+#       All other AIA options are, well, optional.  The --no-output is
 #       used here to cause the response to this executable prompt to be
 #       sent to STDOUT like a good little *nix CLI tool.  Its not necessary.
-#       if you do not use it, the output will go to the default out_file.
+#       if you do not use it, the output will go to the default output file.
 #       You could also specify a specific file to write the output to built
 #       but it is more convential to use the *nix STDOUT redirect "> output.md"
 #

data/lib/aia/aia_completion.bash

@@ -3,7 +3,7 @@
 # the bash shell
 #
 # This script assumes that the system environment
-# variable AIA_PROMPTS_DIR has been set correctly
+# variable AIA_PROMPTS__DIR has been set correctly
 
 _aia_completion() {
   # The current word being completed
@@ -18,7 +18,7 @@ _aia_completion() {
   # Check if we are currently completing the option that requires prompt IDs
   if [[ "$prev_word" == "aia" ]]; then
     # Change directory to the prompts directory
-    cd "$AIA_PROMPTS_DIR" || return
+    cd "$AIA_PROMPTS__DIR" || return
 
     # Generate a list of relative paths from the ~/.prompts directory (without .txt extension)
     local files=($(find . -name "*.txt" -type f | sed 's|^\./||' | sed 's/\.txt$//'))

data/lib/aia/aia_completion.fish

@@ -2,7 +2,7 @@
 # Setup a prompt completion for use with the fish shell
 #
 # This script assumes that the system environment
-# variable AIA_PROMPTS_DIR has been set correctly
+# variable AIA_PROMPTS__DIR has been set correctly
 
 function __fish_aia_complete
   # Get the command line and current token
@@ -12,9 +12,9 @@ function __fish_aia_complete
   # Check if we are currently completing the option that requires prompt IDs
   if set -q cmd_line[2]
     # Change directory to the prompts directory
-    if test -d $AIA_PROMPTS_DIR
-      pushd $AIA_PROMPTS_DIR
-      # Generate completions based on .txt files in the AIA_PROMPTS_DIR directory
+    if test -d $AIA_PROMPTS__DIR
+      pushd $AIA_PROMPTS__DIR
+      # Generate completions based on .txt files in the AIA_PROMPTS__DIR directory
       for file in (find . -name "*.txt" -type f)
         set file (string replace -r '\.txt$' '' -- $file)
         set file (string replace -r '^\./' '' -- $file)

data/lib/aia/aia_completion.zsh

@@ -3,7 +3,7 @@
 # the zsh shell
 #
 # This script assumes that the system environment
-# variable AIA_PROMPTS_DIR has been set correctly
+# variable AIA_PROMPTS__DIR has been set correctly
 
 _aia_completion() {
   # The current word being completed
@@ -18,7 +18,7 @@ _aia_completion() {
   # Check if we are currently completing the option that requires prompt IDs
   if [[ "$prev_word" == "aia" ]]; then
     # Change directory to the prompts directory
-    cd "$AIA_PROMPTS_DIR" || return
+    cd "$AIA_PROMPTS__DIR" || return
 
     # Generate a list of relative paths from the ~/.prompts directory (without .txt extension)
     local files=($(find . -name "*.txt" -type f | sed 's|^\./||' | sed 's/\.txt$//'))