aia 0.5.2 → 0.5.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 35bff72b31591194079e96f6e1dfab9dc76db90fda1f635e962377aeb77b5662
-  data.tar.gz: 60704012ba00cca73bdb6bb344a4207df189b97b5dc2d686a53215836c5d27d5
+  metadata.gz: '021416691c11252ce3462ee7ec394691e0a7d0fd81eb6df473df3447dd02da3b'
+  data.tar.gz: 2bd5eb6bd2098c7e9bd04234a11c1192004bb217ec054aa9222334d9b96309d2
 SHA512:
-  metadata.gz: a7b3f5bb0bee380f3863bfe80599e8898e16143587d374db27f99d27a718433d9e6869da1a8f44207016185c0b28935b5c5edbaf45d939992ad58ecd65a68fa9
-  data.tar.gz: 3f4fd8f0707e55cfc2147090d55ff4c865eba8c14bb22bb07831b3e46653530c9800a8d69f148e978bcb763a91d47ac3b58c1f2ab19e387019d6537b9446059e
+  metadata.gz: 0e2d78c3b6b1b8848645ef586c3b2f7a4557339504efc1a7434b12e313637e47b6803da8e5fa21908f88ee59046a372ef22553a5fdffe97d5777b65845f5ce41
+  data.tar.gz: 142dd7b40622124089363670fcb6ffde02368ad07de7016e6c12e0511a47d89d8b0be9b153d31076758c321e6762e1d361fd4ac086b6f8ffca8d2a2abebeff7b

data/.semver

@@ -1,6 +1,6 @@
 ---
 :major: 0
 :minor: 5
-:patch: 2
+:patch: 6
 :special: ''
 :metadata: ''

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 ## [Unreleased]
 
+## [0.5.6] 2024-01-15
+- Adding processing for directives, shell integration and erb to the follow up prompt in a chat session
+- some code refactoring.
+
+## [0.5.3] 2024-01-14
+- adding ability to render markdown to the terminal using the "glow" CLI utility
+
 ## [0.5.2] 2024-01-13
 - wrap response when its going to the terminal
 

data/README.md

@@ -5,6 +5,15 @@
 It leverages the `prompt_manager` gem to manage prompts for the `mods` and `sgpt` CLI utilities. It utilizes "ripgrep" for searching for prompt files.  It uses `fzf` for prompt selection based on a search term and fuzzy matching.
 
 **Most Recent Change**: Refer to the [Changelog](CHANGELOG.md)
+v0.5.6
+- Directives within a chat session follow up are now available
+- when the `--shell` option is set access to envars and shell scripts are availabe in a chat session follow up prompt
+- when the `--erb` option is set, access to ERB-based dynamic content is available in a chat session follow up prompt.
+
+v0.5.3
+- `--render` will render markdown formatted content to the terminal using the `glow` CLI utility.
+- fixes to some terminal UI stuff like AI response is not being wrapped to the terminal width to make for easier reading.
+- fixed the completion functions to use the correct $AIA_PROMPTS_DIR envar
 
 v0.5.0 - Breaking changes: 
 - `--config` is now `--config_file`
@@ -21,11 +30,14 @@ v0.5.0 - Breaking changes:
   - [Shell Integration inside of a Prompt](#shell-integration-inside-of-a-prompt)
       - [Access to System Environment Variables](#access-to-system-environment-variables)
       - [Dynamic Shell Commands](#dynamic-shell-commands)
+      - [Chat Session Use](#chat-session-use)
   - [*E*mbedded *R*u*B*y (ERB)](#embedded-ruby-erb)
+    - [Chat Session Behavior](#chat-session-behavior)
   - [Prompt Directives](#prompt-directives)
     - [`aia` Specific Directive Commands](#aia-specific-directive-commands)
       - [//config](#config)
     - [Backend Directive Commands](#backend-directive-commands)
+    - [Using Directives in Chat Sessions](#using-directives-in-chat-sessions)
   - [All About ROLES](#all-about-roles)
     - [Other Ways to Insert Roles into Prompts](#other-ways-to-insert-roles-into-prompts)
   - [External CLI Tools Used](#external-cli-tools-used)
@@ -97,7 +109,15 @@ ARGUMENTS
 
 OPTIONS
        --chat begin a chat session with the backend after the initial prompt response;  will
-              set --no-out_file so that the backend response comes to STDOUT.
+              set --no-out_file so that the backend response comes to STDOUT.  After the
+              initial prompt is processed, you will be asked to provide a follow up.  Just
+              enter whatever is appropriate terminating your input with a RETURN.  The
+              backend will provide a response to you follow up and ask you again if you have
+              another follow up. This back and forth chatting will continue until you enter a
+              RETURN without any other content - an empty follow up prompt.  You may also
+              enter a directive to be processed after which another follow up is requested.
+              If you have the --shell and/or the --erb options set you may use those tools
+              within your follow up to provide dynamic content.
 
        --completion SHELL_NAME
 
@@ -125,6 +145,9 @@ OPTIONS
        --model NAME
               Name of the LLM model to use - default is gpt-4-1106-preview
 
+       --render
+              Render markdown to the terminal using the external tool “glow” - default: false
+
        --speak
               Simple implementation. Uses the “say” command to speak the response.  Fun with
               --chat
@@ -251,12 +274,29 @@ SEE ALSO
                 text, and more, using simple commands. Streamline your workflow and enhance
                 productivity with this powerful and user-friendly CLI tool.
 
+              • fzf <https://github.com/junegunn/fzf>
+                 fzf is a general-purpose command-line fuzzy finder.  It’s an interactive
+                Unix filter for command-line that can be used with any list; files, command
+                history, processes, hostnames, bookmarks, git commits, etc.
+
+              • ripgrep <https://github.com/BurntSushi/ripgrep>
+                 Search tool like grep and The Silver Searcher. It is a line-oriented search
+                tool that recursively searches a directory tree for a regex pattern. By
+                default, ripgrep will respect gitignore rules and automatically skip hidden
+                files/directories and binary files. (To disable all automatic filtering by
+                default, use rg -uuu.) ripgrep has first class support on Windows, macOS and
+                Linux, with binary downloads available for every release.
+
+              • glow <https://github.com/charmbracelet/glow>
+                 Render markdown on the CLI
+
 AUTHOR
        Dewayne VanHoozer <dvanhoozer@gmail.com>
 
 AIA                                       2024-01-01                                   aia(1)
 ```
 
+
 ## Configuration Using Envars
 
 The `aia` configuration defaults can be over-ridden by system environment variables *(envars)* with the prefix "AIA_" followed by the config item name also in uppercase. All configuration items can be over-ridden in this way by an envar.  The following table show a few examples.
@@ -305,6 +345,15 @@ or insert content from a file in your home directory:
 Given the following constraints $(cat ~/3_laws_of_robotics.txt) determine the best way to instruct my roomba to clean my kids room.
 ```
 
+#### Chat Session Use
+
+When you use the `--shell` option to start a chat session, shell integration is available in your follow up prompts.  Suppose you started up a chat session using a roll of "Ruby Expert" expecting to chat about changes that could be made to a specific class BUT you forgot to include the class source file as part of the context when you got started.  You could enter this as your follow up prompt to this to keep going:
+
+```
+The class I want to chat about refactoring is this one: $(cat my_class.rb)
+```
+
+That inserts the entire class source file into your follow up prompt.  You can continue chatting with you AI Assistant avout changes to the class.
 
 ## *E*mbedded *R*u*B*y (ERB)
 
@@ -314,6 +363,11 @@ The `--erb` option turns the prompt text file into a fully functioning ERB templ
 
 Most websites that have information about ERB will give examples of how to use ERB to generate dynamice HTML content for web-based applications.  That is a common use case for ERB.  `aia` on the other hand uses ERB to generate dynamic prompt text.
 
+### Chat Session Behavior
+
+In a chat session whether started by the `--chat` option or its equivalent with a directive within a prompt text file behaves a little differently w/r/t its binding and local variable assignments.  Since a chat session by definition has multiple prompts, setting a local variable in one prompt and expecting it to be available in a subsequent prompt does not work.  You need to use instance variables to accomplish this prompt to prompt carry over of information.
+
+Also since follow up prompts are expected to be a single thing - sentence or paragraph - terminated by a single return, its likely that ERB enhance will be of benefit; but, you may find a use for it.
 
 ## Prompt Directives
 
@@ -367,6 +421,17 @@ FOr example `mods` has a configuration item `topp` which can be set by a directi
 
 If `mods` is not the backend the `//topp` direcive is ignored.
 
+### Using Directives in Chat Sessions
+
+Whe you are in a chat session, you may use a directive as a follow up prompt.  For example if you started the chat session with the option `--terse` expecting to get short answers from the backend; but, then you decide that you want more comprehensive answers you may do this:
+
+```
+//config terse? false
+```
+
+The directive is executed and a new follow up prompt can be entered with a more lengthy response generated from the backend.
+
+
 ## All About ROLES
 
 `aia` provides the `--role` CLI option to identify a prompt ID within your prompts directory which defines the context within which the LLM is to provide its response.  The text of the role ID is pre-pended to the text of the primary prompt to form a complete prompt to be processed by the backend.
@@ -402,31 +467,32 @@ When this prompt is processed, `aia` will ask you for a value for the keyword "R
 
 ## External CLI Tools Used
 
-```text
-External Tools Used
--------------------
-
 To install the external CLI programs used by aia:
-  brew install fzf mods rg
+  
+  brew install fzf mods rg glow
 
 fzf
   Command-line fuzzy finder written in Go
-  https://github.com/junegunn/fzf
+  [https://github.com/junegunn/fzf](https://github.com/junegunn/fzf)
 
 mods
   AI on the command-line
-  https://github.com/charmbracelet/mods
+  [https://github.com/charmbracelet/mods](https://github.com/charmbracelet/mods)
 
 rg
   Search tool like grep and The Silver Searcher
-  https://github.com/BurntSushi/ripgrep
+  [https://github.com/BurntSushi/ripgrep](https://github.com/BurntSushi/ripgrep)
+
+glow
+  Render markdown on the CLI
+  [https://github.com/charmbracelet/glow](https://github.com/charmbracelet/glow)
 
 A text editor whose executable is setup in the
 system environment variable 'EDITOR' like this:
 
-export EDITOR="subl -w"
+  export EDITOR="subl -w"
+
 
-```
 
 ## Shell Completion
 

data/lib/aia/cli.rb

@@ -125,18 +125,19 @@ class AIA::Cli
       dump:       [nil,       "--dump"],
       completion: [nil,       "--completion"],
       #
+      chat?:      [false,     "--chat"],
+      debug?:     [false,     "-d --debug"],
       edit?:      [false,     "-e --edit"],
-      shell?:     [false,     "--shell"],
       erb?:       [false,     "--erb"],
-      debug?:     [false,     "-d --debug"],
-      verbose?:   [false,     "-v --verbose"],
-      version?:   [false,     "--version"],
-      help?:      [false,     "-h --help"],
       fuzzy?:     [false,     "-f --fuzzy"],
+      help?:      [false,     "-h --help"],
       markdown?:  [true,      "-m --markdown --no-markdown --md --no-md"],
-      chat?:      [false,     "--chat"],
-      terse?:     [false,     "--terse"],
+      render?:    [false,     "--render"],
+      shell?:     [false,     "--shell"],
       speak?:     [false,     "--speak"],
+      terse?:     [false,     "--terse"],
+      verbose?:   [false,     "-v --verbose"],
+      version?:   [false,     "--version"],
       #
       role:       ['',        "-r --role"],
       #

data/lib/aia/directives.rb

@@ -2,13 +2,15 @@
 
 require 'hashie'
 
-class AIA::Directives
-  def initialize( prompt: )
-    @prompt = prompt  # PromptManager::Prompt instance
-    AIA.config.directives = @prompt.directives
-  end
+=begin
+  AIA.config.directives is an Array of Arrays.  An
+  entry looks like this:
+    [directive, parameters]
+  where both are String objects
+=end
 
 
+class AIA::Directives
   def execute_my_directives
     return if AIA.config.directives.nil? || AIA.config.directives.empty?
     

data/lib/aia/dynamic_content.rb

@@ -0,0 +1,26 @@
+# aia/lib/aia/dynamic_content.rb
+
+require 'erb'
+
+module AIA::DynamicContent
+
+  # inserts environment variables (envars) and dynamic content into a prompt
+  # replaces patterns like $HOME and ${HOME} with the value of ENV['HOME']
+  # replaces patterns like $(shell command) with the output of the shell command
+  #
+  def render_env(a_string)
+    a_string.gsub(/\$(\w+|\{\w+\})/) do |match|
+      ENV[match.tr('$', '').tr('{}', '')]
+    end.gsub(/\$\((.*?)\)/) do |match|
+      `#{match[2..-2]}`.chomp
+    end
+  end
+
+
+  # Need to use instance variables in assignments
+  # to maintain binding from one follow up prompt
+  # to another.
+  def render_erb(the_prompt_text)
+    ERB.new(the_prompt_text).result(binding)
+  end
+end

data/lib/aia/main.rb

@@ -5,6 +5,7 @@ module AIA ; end
 require_relative 'config'
 require_relative 'cli'
 require_relative 'directives'
+require_relative 'dynamic_content'
 require_relative 'prompt'
 require_relative 'logging'
 require_relative 'tools'
@@ -13,6 +14,7 @@ require_relative 'tools'
 # of a single class.
 
 class AIA::Main
+  include AIA::DynamicContent
 
   attr_accessor :logger, :tools, :backend
 
@@ -33,7 +35,8 @@ class AIA::Main
 
     @prompt = AIA::Prompt.new.prompt
 
-    @engine = AIA::Directives.new(prompt: @prompt)
+
+    @directives_processor = AIA::Directives.new 
 
     # TODO: still should verify that the tools are ion the $PATH
     # tools.class.verify_tools
@@ -57,6 +60,7 @@ class AIA::Main
   # Function to prompt the user with a question using reline
   def ask_question_with_reline(prompt)
     if prompt.start_with?("\n")
+      puts
       puts
       prompt = prompt[1..]
     end
@@ -70,7 +74,7 @@ class AIA::Main
 
 
   def call
-    @engine.execute_my_directives
+    @directives_processor.execute_my_directives
 
     if AIA.config.chat?
       AIA.config.out_file = STDOUT 
@@ -111,20 +115,10 @@ class AIA::Main
                   files:          AIA.config.arguments    # FIXME: want validated context files
                 )
 
-
-    result  = backend.run
-
-    if STDOUT == AIA.config.out_file
-      result  = result.wrap(indent: 2)
-    end
-
-    # TODO: consider using glow to render markdown to
-    #       terminal `brew install glow`
-    AIA.config.out_file.write result
+    result = get_and_display_result(the_prompt)
 
     logger.prompt_result(@prompt, result)
 
-
     if AIA.config.chat?
       setup_reline_history
       speak result
@@ -133,36 +127,87 @@ class AIA::Main
   end
 
 
-  def lets_chat
+  def get_and_display_result(the_prompt_text)
+    backend.text  = the_prompt_text
+    result        = backend.run
+
+    AIA.config.out_file.write "\nResponse:\n"
+
+    if STDOUT == AIA.config.out_file
+      if AIA.config.render?
+        AIA::Glow.new(content: result).run
+      else
+        result  = result.wrap(indent: 2)
+        AIA.config.out_file.write result
+      end
+    else
+      AIA.config.out_file.write result
+      if AIA.config.render?
+        AIA::Glow.new(file_path: AIA.config.out_file).run
+      end
+    end
+
+    result
+  end
+
+
+  def log_the_follow_up(the_prompt_text, result)
+    logger.info "Follow Up:\n#{the_prompt_text}"
+    logger.info "Response:\n#{result}"
+  end
+
+
+  def add_continue_option
     if 'mods' == AIA.config.backend
-      AIA.config.extra += " -C"
+      continue_option   = " -C"
+      AIA.config.extra += continue_option unless AIA.config.extra.include?(continue_option)
     end
-    
-    backend.text = ask_question_with_reline("\nFollow Up: ")
-    
-    until backend.text.empty?
-      if AIA.config.terse?
-        backend.text.prepend "Be terse in your response. "
-      end
-      
-      logger.info "Follow Up: #{backend.text}"
-      response = backend.run
-      
-      speak response
-
-      puts "\nResponse:\n#{response.wrap(indent: 2)}"
-      logger.info "Response: #{backend.run}"
+  end
+
+
+  def insert_terse_phrase(a_string)
+    if AIA.config.terse?
+      a_string.prepend "Be terse in your response. "
+    end
+
+    a_string
+  end
+
   
-      # TODO: Allow user to enter a directive; loop
-      #       until answer is not a directive
-      #
-      # while !directive do
-      backend.text = ask_question_with_reline("\nFollow Up: ")
-      
-      speak backend.text
-
-      # execute the directive
-      # end
+  def handle_directives(the_prompt_text)
+    signal = PromptManager::Prompt::DIRECTIVE_SIGNAL
+    result = the_prompt_text.start_with?(signal)
+
+    if result
+      parts       = the_prompt_text[signal.size..].split(' ')
+      directive   = parts.shift
+      parameters  = parts.join(' ')
+      AIA.config.directives << [directive, parameters]
+      @directives_processor.execute_my_directives
+    end
+
+    result
+  end
+
+
+  def lets_chat
+    add_continue_option    
+
+    the_prompt_text = ask_question_with_reline("\nFollow Up: ")
+
+    until the_prompt_text.empty?
+      the_prompt_text   = render_erb(the_prompt_text) if AIA.config.erb?
+      the_prompt_text   = render_env(the_prompt_text) if AIA.config.shell?
+
+      unless handle_directives(the_prompt_text)
+        the_prompt_text = insert_terse_phrase(the_prompt_text)
+        result          = get_and_display_result(the_prompt_text)
+
+        log_the_follow_up(the_prompt_text, result)
+        speak result
+      end
+
+      the_prompt_text = ask_question_with_reline("\nFollow Up: ")
     end
   end
 end

data/lib/aia/prompt.rb

@@ -1,9 +1,12 @@
 # lib/aia/prompt.rb
 
 require 'reline'
-require 'erb'
+
+require_relative 'dynamic_content'
 
 class AIA::Prompt
+  include AIA::DynamicContent
+
   #
   # used when no prompt_id is provided but there
   # are extra parameters that need to be passed
@@ -42,9 +45,11 @@ class AIA::Prompt
 
     if build
       @prompt.text = render_erb(@prompt.text)   if AIA.config.erb?
-      @prompt.text = replace_env(@prompt.text)  if AIA.config.shell?
+      @prompt.text = render_env(@prompt.text)   if AIA.config.shell?
       process_prompt 
     end
+
+    AIA.config.directives = @prompt.directives
   end
 
 
@@ -93,25 +98,6 @@ class AIA::Prompt
   end
 
 
-  # inserts environmant variables and dynamic content into a prompt
-  # replaces patterns like $HOME and ${HOME} with the value of ENV['HOME']
-  # replaces patterns like $(shell command) with the output of the shell command
-  #
-  def replace_env(a_string)
-    a_string.gsub(/\$(\w+|\{\w+\})/) do |match|
-      ENV[match.tr('$', '').tr('{}', '')]
-    end.gsub(/\$\((.*?)\)/) do |match|
-      `#{match[2..-2]}`.chomp
-    end
-  end
-
-
-  # You are just asking for trouble!
-  def render_erb(a_string)
-    ERB.new(a_string).result(binding)
-  end
-
-
   def replace_keywords
     puts
     puts "ID: #{@prompt.id}"
@@ -151,6 +137,7 @@ class AIA::Prompt
   # Function to prompt the user with a question using reline
   def ask_question_with_reline(prompt)
     if prompt.start_with?("\n")
+      puts
       puts
       prompt = prompt[1..]
     end

data/lib/aia/tools/backend_common.rb

@@ -12,9 +12,12 @@ module AIA::BackendCommon
     build_command
   end
 
+
   def sanitize(input)
     Shellwords.escape(input)
   end
+
+
   def build_command
     @parameters += " --model #{AIA.config.model} " if AIA.config.model
     @parameters += AIA.config.extra
@@ -29,6 +32,7 @@ module AIA::BackendCommon
     @command
   end
 
+
   def set_parameter_from_directives
     AIA.config.directives.each do |entry|
       directive, value = entry
@@ -38,6 +42,7 @@ module AIA::BackendCommon
     end
   end
 
+
   def run
     case @files.size
     when 0
@@ -45,32 +50,9 @@ module AIA::BackendCommon
     when 1
       @result = `#{build_command} < #{@files.first}`
     else
-      create_temp_file_with_contexts
-      run_with_temp_file
-      clean_up_temp_file
+      @result = %x[cat #{@files.join(' ')} | #{build_command}]
     end
 
     @result
   end
-
-  def create_temp_file_with_contexts
-    @temp_file = Tempfile.new("#{self.class::COMMAND_NAME}-context")
-
-    @files.each do |file|
-      content = File.read(file)
-      @temp_file.write(content)
-      @temp_file.write("\n")
-    end
-
-    @temp_file.close
-  end
-
-  def run_with_temp_file
-    command = "#{build_command} < #{@temp_file.path}"
-    @result = `#{command}`
-  end
-
-  def clean_up_temp_file
-    @temp_file.unlink if @temp_file
-  end
 end

data/lib/aia/tools/glow.rb

@@ -0,0 +1,90 @@
+# aia/lib/aia/tools/glow.rb
+
+require 'tempfile'
+require 'tty-screen'
+require 'shellwords'
+
+
+=begin
+
+  This class supports two use cases:
+  1) rendering markdown from an existing file
+  2) rendering markdown from a String object via a temporary file
+
+  In both cases a String object is created and returned that contains the
+  rendered version of the content so that it can be written to STDOUT
+  by the caller.
+
+=end
+
+class AIA::Glow < AIA::Tools
+
+  meta(
+    name:     'glow',
+    role:     :markdown_renderer,
+    desc:     "A markdown renderer utility",
+    url:      "https://github.com/charmbracelet/glow",
+    install:  "brew install glow",
+  )
+
+  DEFAULT_PARAMETERS = "--width #{TTY::Screen.width-2}" # Magic: -2 just because I want it
+
+  attr_accessor :content, :file_path
+
+
+  def initialize(content: nil, file_path: nil)
+    @content = content
+    @file_path = file_path
+  end
+
+
+  def build_command(file_path)
+    "#{self.class.meta[:name]} #{DEFAULT_PARAMETERS} #{Shellwords.escape(file_path)}"
+  end
+
+
+  def run
+    return unless content || file_path
+
+    if @file_path && File.exist?(@file_path)
+      command = build_command(@file_path)
+      system(command)
+    else
+      Tempfile.create(['glow', '.md']) do |file|
+        file.write(@content)
+        file.close
+        command = build_command(file.path)
+        system(command)
+      end
+    end
+  end
+end
+
+__END__
+
+$ glow --help
+
+  Render markdown on the CLI, with pizzazz!
+
+Usage:
+  glow [SOURCE|DIR] [flags]
+  glow [command]
+
+Available Commands:
+  completion  Generate the autocompletion script for the specified shell
+  config      Edit the glow config file
+  help        Help about any command
+  stash       Stash a markdown
+
+Flags:
+  -a, --all             show system files and directories (TUI-mode only)
+      --config string   config file (default /Users/dewayne/Library/Preferences/glow/glow.yml)
+  -h, --help            help for glow
+  -l, --local           show local files only; no network (TUI-mode only)
+  -p, --pager           display with pager
+  -s, --style string    style name or JSON path (default "auto")
+  -v, --version         version for glow
+  -w, --width uint      word-wrap at width
+
+Use "glow [command] --help" for more information about a command.
+

data/man/aia.1

@@ -23,7 +23,7 @@ External options are optional\.  Anything that follow \[lq] \-\- \[lq] will be s
 .SH OPTIONS
 .TP
 \fB\-\-chat\fR
-begin a chat session with the backend after the initial prompt response;  will set \-\-no\-out\[ru]file so that the backend response comes to STDOUT\.
+begin a chat session with the backend after the initial prompt response;  will set \-\-no\-out\[ru]file so that the backend response comes to STDOUT\.  After the initial prompt is processed, you will be asked to provide a follow up\.  Just enter whatever is appropriate terminating your input with a RETURN\.  The backend will provide a response to you follow up and ask you again if you have another follow up\. This back and forth chatting will continue until you enter a RETURN without any other content \- an empty follow up prompt\.  You may also enter a directive to be processed after which another follow up is requested\.  If you have the \fB\-\-shell\fR and\[sl]or the \fB\-\-erb\fR options set you may use those tools within your follow up to provide dynamic content\.
 .TP
 \fB\-\-completion\fR \fISHELL\[ru]NAME\fP
 .TP
@@ -41,6 +41,9 @@ If dynamic prompt content using \[Do](\.\.\.) wasn\[cq]t enough here is ERB\.  E
 \fB\-\-model\fR \fINAME\fP
 Name of the LLM model to use \- default is gpt\-4\-1106\-preview
 .TP
+\fB\-\-render\fR
+Render markdown to the terminal using the external tool \[lq]glow\[rq] \- default: false
+.TP
 \fB\-\-speak\fR
 Simple implementation\. Uses the \[lq]say\[rq] command to speak the response\.  Fun with \-\-chat
 .TP
@@ -147,6 +150,21 @@ sgpt
 .UR https:\[sl]\[sl]github\.com\[sl]tbckr\[sl]sgpt
 .UE
  (aka shell\-gpt) is a powerful command\-line interface (CLI) tool designed for seamless interaction with OpenAI models directly from your terminal\. Effortlessly run queries, generate shell commands or code, create images from text, and more, using simple commands\. Streamline your workflow and enhance productivity with this powerful and user\-friendly CLI tool\.
+.IP \(bu 2
+fzf
+.UR https:\[sl]\[sl]github\.com\[sl]junegunn\[sl]fzf
+.UE
+ fzf is a general\-purpose command\-line fuzzy finder\.  It\[cq]s an interactive Unix filter for command\-line that can be used with any list; files, command history, processes, hostnames, bookmarks, git commits, etc\.
+.IP \(bu 2
+ripgrep
+.UR https:\[sl]\[sl]github\.com\[sl]BurntSushi\[sl]ripgrep
+.UE
+ Search tool like grep and The Silver Searcher\. It is a line\-oriented search tool that recursively searches a directory tree for a regex pattern\. By default, ripgrep will respect gitignore rules and automatically skip hidden files\[sl]directories and binary files\. (To disable all automatic filtering by default, use rg \-uuu\.) ripgrep has first class support on Windows, macOS and Linux, with binary downloads available for every release\.
+.IP \(bu 2
+glow
+.UR https:\[sl]\[sl]github\.com\[sl]charmbracelet\[sl]glow
+.UE
+ Render markdown on the CLI
 .RE
 .SH AUTHOR
 .PP

data/man/aia.1.md

@@ -26,7 +26,7 @@ The aia command-line tool is an interface for interacting with an AI model backe
 ## OPTIONS
 
 `--chat`
-: begin a chat session with the backend after the initial prompt response;  will set --no-out_file so that the backend response comes to STDOUT.
+: begin a chat session with the backend after the initial prompt response;  will set --no-out_file so that the backend response comes to STDOUT.  After the initial prompt is processed, you will be asked to provide a follow up.  Just enter whatever is appropriate terminating your input with a RETURN.  The backend will provide a response to you follow up and ask you again if you have another follow up. This back and forth chatting will continue until you enter a RETURN without any other content - an empty follow up prompt.  You may also enter a directive to be processed after which another follow up is requested.  If you have the `--shell` and/or the `--erb` options set you may use those tools within your follow up to provide dynamic content.
 
 `--completion` *SHELL_NAME*
 : Show completion script for bash|zsh|fish - default is nil
@@ -46,6 +46,9 @@ The aia command-line tool is an interface for interacting with an AI model backe
 `--model` *NAME*
 : Name of the LLM model to use - default is gpt-4-1106-preview
 
+`--render`
+: Render markdown to the terminal using the external tool "glow" - default: false
+
 `--speak`
 : Simple implementation. Uses the "say" command to speak the response.  Fun with --chat
 
@@ -135,6 +138,13 @@ Detail discussion on individual prompt directives is TBD.  Most likely it will b
 
 - [sgpt](https://github.com/tbckr/sgpt) (aka shell-gpt) is a powerful command-line interface (CLI) tool designed for seamless interaction with OpenAI models directly from your terminal. Effortlessly run queries, generate shell commands or code, create images from text, and more, using simple commands. Streamline your workflow and enhance productivity with this powerful and user-friendly CLI tool.
 
+- [fzf](https://github.com/junegunn/fzf) fzf is a general-purpose command-line fuzzy finder.  It's an interactive Unix filter for command-line that can be used with any list; files, command history, processes, hostnames, bookmarks, git commits, etc.
+
+- [ripgrep](https://github.com/BurntSushi/ripgrep) Search tool like grep and The Silver Searcher. It is a line-oriented search tool that recursively searches a directory tree for a regex pattern. By default, ripgrep will respect gitignore rules and automatically skip hidden files/directories and binary files. (To disable all automatic filtering by default, use rg -uuu.) ripgrep has first class support on Windows, macOS and Linux, with binary downloads available for every release. 
+
+- [glow](https://github.com/charmbracelet/glow) Render markdown on the CLI
+
+
 ## AUTHOR
 
 Dewayne VanHoozer <dvanhoozer@gmail.com>

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aia
 version: !ruby/object:Gem::Version
-  version: 0.5.2
+  version: 0.5.6
 platform: ruby
 authors:
 - Dewayne VanHoozer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-01-13 00:00:00.000000000 Z
+date: 2024-01-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: hashie
@@ -94,6 +94,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: tty-screen
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: tty-spinner
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -164,12 +192,18 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: "A command-line AI Assistante (aia) that provides\nparameterized prompt
-  management (via the prompt_manager gem) to\nvarious backend gen-AI processes.  aia
-  currently supports the \"mods\"\nCLI tool.  aia uses \"ripgrep\" and \"fzf\" CLI
-  utilities \nto search for and select prompt files to send to the backend gen-AI\ntool
-  along with supported context files.  Example usage: \"aia refactor my_class.rb\"
-  \nwhere \"refactor\" is the prompt ID for the file \"refactor.txt\" from your\nRPROMPTS_DIR\n"
+description: |
+  `aia` - the AI Assistant - is a command-line (CLI) tool for
+  interfacing with generative AI (gen-AI/GPT) backends.  Its designed
+  to provide developers with the ability to issue prompts, receive
+  AI-generated responses, and incorporate additional context from files
+  such as Ruby source code. It supports configuration and customization
+  for different environments, includes options for output formats like
+  markdown rendering or spoken responses, and allows dynamic content
+  generation within prompts such as shell integration and embedded
+  Ruby. With `aia`, users benefit from a simplified setup process and
+  an extendable interaction model with AI, suitable for a range of
+  command-line tasks.
 email:
 - dvanhoozer@gmail.com
 executables:
@@ -195,12 +229,14 @@ files:
 - lib/aia/cli.rb
 - lib/aia/config.rb
 - lib/aia/directives.rb
+- lib/aia/dynamic_content.rb
 - lib/aia/logging.rb
 - lib/aia/main.rb
 - lib/aia/prompt.rb
 - lib/aia/tools.rb
 - lib/aia/tools/backend_common.rb
 - lib/aia/tools/editor.rb
+- lib/aia/tools/glow.rb
 - lib/aia/tools/mods.rb
 - lib/aia/tools/sgpt.rb
 - lib/aia/tools/subl.rb