aia 0.0.5 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a080fd671c1e5e3f9420f036892afb69a8d4190745da8bbce82620356ae2ad10
-  data.tar.gz: ffe746cbcb3a24216f39f4ec220b962828ab925041fe6f97f006676988006690
+  metadata.gz: c4d68353a3458a4a3e485acbf09ec6444e63d33ddaedca66a1f48aaf38b31a96
+  data.tar.gz: b2d07bde2cb329db6f23ccda5c845b67251f00f5bdfab680406d671a32ee0b32
 SHA512:
-  metadata.gz: 6ac1c123e391a981800ac8777e31de96cc68af4747e0756902c3f3bd6eaa3fef4c23e425ff7d951c63f93ee5dbb85c1573f8434958dd3e6ce142579f52bf7bd6
-  data.tar.gz: ed7e48ffa949db795884eb0d552a3ac312079dce7152fd45643191f2907ff5a697d334cc26a492cee44a649420fecaf9d6063dfc72ff82e7bd226dc2a77e81c6
+  metadata.gz: d27e5190de909b14a71a52f2eea78b8d948de6cbe5c621f3b10e819404d0a9a78087c5da748598b6dfbf8af88ece61382c407d62382eadb062ad0582d5f4b8f9
+  data.tar.gz: 6cc9b0ad1d570f0cb994e06af614d4faea07b356303042fa1e1bfe03ed12a62f273824e0240b8bb2cb46a64b6f195dd715b15161a228255f3d2639fc1648e61e

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+## [0.3.0] = 2023-11-23
+
+- Matching version to [prompt_manager](https://github.com/prompt_manager) This version allows for the user of history in the entery of values to prompt keywords.  KW_HISTORY_MAX is set at 5.  Changed CLI enteraction to use historical selection and editing of prior keyword values.
+
 ## [0.1.0] - 2023-11-23
 
 - Initial release

data/README.md

@@ -1,11 +1,27 @@
 # AI Assistant (AIA)
 
-**Under Development**
-
 `aia` is a command-line utility that integrates prameterized prompt management with generative AI (gen-AI) execution.
 
 Uses the gem "prompt_manager" to manage the prompts sent to the `mods` command-line utility.  Uses the command line tools "ripgrep" to search for prompts to send and "fzf" to select the prompts that match the search term.
 
+**Most Recent Change**
+
+v0.3.0 - Matching version to [prompt_manager](https://github.com/prompt_manager) This version allows for the user of history in the entery of values to prompt keywords.  KW_HISTORY_MAX is set at 5.  Changed CLI enteraction to use historical selection and editing of prior keyword values.
+
+
+<!-- Tocer[start]: Auto-generated, don't remove. -->
+
+## Table of Contents
+
+  - [Installation](#installation)
+  - [Usage](#usage)
+  - [System Environment Variables (envars)](#system-environment-variables-envars)
+  - [External CLI Tools Used](#external-cli-tools-used)
+  - [Development](#development)
+  - [Contributing](#contributing)
+  - [License](#license)
+
+<!-- Tocer[finish]: Auto-generated, don't remove. -->
 
 
 ## Installation
@@ -138,6 +154,12 @@ export EDITOR="subl -w"
 
 ```
 
+## Shell Completion
+
+One of the executables with this gem is `aia_completion.sh` which contains a completion script for hte `aia` such that you specify the first few characters of a prompt ID on the command line and the shell will complete the rest of the ID for you.  It works with the `bash` shell but do not know whether it works with the other shells.
+
+To set the completion you can execute aia_completion.sh` in your `.bashrc`  however, the PROMPTS_DIR environment variable must be set in order for prompt ID to work correctly.
+
 
 ## Development
 

data/lib/aia/cli.rb

@@ -3,6 +3,7 @@
 module AIA::Cli
   def setup_cli_options(args)
     @arguments  = args
+    # TODO: consider a fixed config file: ~/,aia
     @options    = {
       #           Value
       edit?:      [false, "-e --edit",    "Edit the Prompt File"],
@@ -16,6 +17,7 @@ module AIA::Cli
       output:     [OUTPUT,"-o --output --no-output",  "Out FILENAME"],
       log:        [PROMPT_LOG,"-l --log --no-log", "Log FILEPATH"],
       markdown?:  [true,  "-m --markdown --no-markdown --md --no-md", "Format with Markdown"],
+      backend:    [:mods, "-b --be --backend --no-backend", "Specify the backend prompt resolver"],
     }
     
     # Array(String)
@@ -175,35 +177,3 @@ module AIA::Cli
     exit
   end
 end
-
-
-__END__
-
-
-# TODO: Consider using this history process to preload the default
-#       so that an up arrow will bring the previous answer into
-#       the read buffer for line editing.
-#       Instead of usin the .history file just push the default
-#       value from the JSON file.
-
-while input = Readline.readline('> ', true)
-  # Skip empty entries and duplicates
-  if input.empty? || Readline::HISTORY.to_a[-2] == input
-    Readline::HISTORY.pop
-  end
-  break if input == 'exit'
-
-  # Do something with the input
-  puts "You entered: #{input}"
-
-  # Save the history in case you want to preserve it for the next sessions
-  File.open('.history', 'a') { |f| f.puts(input) }
-end
-
-# Load history from file at the beginning of the program
-if File.exist?('.history')
-  File.readlines('.history').each do |line|
-    Readline::HISTORY.push(line.chomp)
-  end
-end
-

data/lib/aia/external/.irbrc

@@ -0,0 +1,11 @@
+
+
+
+module AIA
+  module External
+  end
+end
+
+require_relative 'tool'
+include AIA
+include External

data/lib/aia/external/ag.rb

@@ -0,0 +1,103 @@
+# lib/aia/external/ag.rb
+
+class AIA::External::Ag < AIA::External::Tool
+  def initialize
+    super
+    @role = :search
+    @desc = "the_silver_searcher Code-search similar to ack"
+    @url  = "https://github.com/ggreer/the_silver_searcher"
+  end
+end
+
+__END__
+
+Usage: ag [FILE-TYPE] [OPTIONS] PATTERN [PATH]
+
+  Recursively search for PATTERN in PATH.
+  Like grep or ack, but faster.
+
+Example:
+  ag -i foo /bar/
+
+Output Options:
+     --ackmate            Print results in AckMate-parseable format
+  -A --after [LINES]      Print lines after match (Default: 2)
+  -B --before [LINES]     Print lines before match (Default: 2)
+     --[no]break          Print newlines between matches in different files
+                          (Enabled by default)
+  -c --count              Only print the number of matches in each file.
+                          (This often differs from the number of matching lines)
+     --[no]color          Print color codes in results (Enabled by default)
+     --color-line-number  Color codes for line numbers (Default: 1;33)
+     --color-match        Color codes for result match numbers (Default: 30;43)
+     --color-path         Color codes for path names (Default: 1;32)
+     --column             Print column numbers in results
+     --[no]filename       Print file names (Enabled unless searching a single file)
+  -H --[no]heading        Print file names before each file's matches
+                          (Enabled by default)
+  -C --context [LINES]    Print lines before and after matches (Default: 2)
+     --[no]group          Same as --[no]break --[no]heading
+  -g --filename-pattern PATTERN
+                          Print filenames matching PATTERN
+  -l --files-with-matches Only print filenames that contain matches
+                          (don't print the matching lines)
+  -L --files-without-matches
+                          Only print filenames that don't contain matches
+     --print-all-files    Print headings for all files searched, even those that
+                          don't contain matches
+     --[no]numbers        Print line numbers. Default is to omit line numbers
+                          when searching streams
+  -o --only-matching      Prints only the matching part of the lines
+     --print-long-lines   Print matches on very long lines (Default: >2k characters)
+     --passthrough        When searching a stream, print all lines even if they
+                          don't match
+     --silent             Suppress all log messages, including errors
+     --stats              Print stats (files scanned, time taken, etc.)
+     --stats-only         Print stats and nothing else.
+                          (Same as --count when searching a single file)
+     --vimgrep            Print results like vim's :vimgrep /pattern/g would
+                          (it reports every match on the line)
+  -0 --null --print0      Separate filenames with null (for 'xargs -0')
+
+Search Options:
+  -a --all-types          Search all files (doesn't include hidden files
+                          or patterns from ignore files)
+  -D --debug              Ridiculous debugging (probably not useful)
+     --depth NUM          Search up to NUM directories deep (Default: 25)
+  -f --follow             Follow symlinks
+  -F --fixed-strings      Alias for --literal for compatibility with grep
+  -G --file-search-regex  PATTERN Limit search to filenames matching PATTERN
+     --hidden             Search hidden files (obeys .*ignore files)
+  -i --ignore-case        Match case insensitively
+     --ignore PATTERN     Ignore files/directories matching PATTERN
+                          (literal file/directory names also allowed)
+     --ignore-dir NAME    Alias for --ignore for compatibility with ack.
+  -m --max-count NUM      Skip the rest of a file after NUM matches (Default: 10,000)
+     --one-device         Don't follow links to other devices.
+  -p --path-to-ignore STRING
+                          Use .ignore file at STRING
+  -Q --literal            Don't parse PATTERN as a regular expression
+  -s --case-sensitive     Match case sensitively
+  -S --smart-case         Match case insensitively unless PATTERN contains
+                          uppercase characters (Enabled by default)
+     --search-binary      Search binary files for matches
+  -t --all-text           Search all text files (doesn't include hidden files)
+  -u --unrestricted       Search all files (ignore .ignore, .gitignore, etc.;
+                          searches binary and hidden files as well)
+  -U --skip-vcs-ignores   Ignore VCS ignore files
+                          (.gitignore, .hgignore; still obey .ignore)
+  -v --invert-match
+  -w --word-regexp        Only match whole words
+  -W --width NUM          Truncate match lines after NUM characters
+  -z --search-zip         Search contents of compressed (e.g., gzip) files
+
+File Types:
+The search can be restricted to certain types of files. Example:
+  ag --html needle
+  - Searches for 'needle' in files with suffix .htm, .html, .shtml or .xhtml.
+
+For a list of supported file types run:
+  ag --list-file-types
+
+ag was originally created by Geoff Greer. More information (and the latest release)
+can be found at http://geoff.greer.fm/ag

data/lib/aia/external/bat.rb

@@ -0,0 +1,189 @@
+# lib/aia/external/bat.rb
+
+class AIA::External::Bat < AIA::External::Tool
+  def initialize
+    super
+    @role = :render
+    @desc = 'Clone of cat(1) with syntax highlighting and Git integration'
+    @url  = 'https://github.com/sharkdp/bat'
+  end
+end
+
+__END__
+
+
+A cat(1) clone with syntax highlighting and Git integration.
+
+Usage: bat [OPTIONS] [FILE]...
+       bat <COMMAND>
+
+Arguments:
+  [FILE]...
+          File(s) to print / concatenate. Use a dash ('-') or no argument at all to read from
+          standard input.
+
+Options:
+  -A, --show-all
+          Show non-printable characters like space, tab or newline. This option can also be
+          used to print binary files. Use '--tabs' to control the width of the
+          tab-placeholders.
+
+      --nonprintable-notation <notation>
+          Set notation for non-printable characters.
+          
+          Possible values:
+            * unicode (␇, ␊, ␀, ..)
+            * caret   (^G, ^J, ^@, ..)
+
+  -p, --plain...
+          Only show plain style, no decorations. This is an alias for '--style=plain'. When
+          '-p' is used twice ('-pp'), it also disables automatic paging (alias for
+          '--style=plain --paging=never').
+
+  -l, --language <language>
+          Explicitly set the language for syntax highlighting. The language can be specified as
+          a name (like 'C++' or 'LaTeX') or possible file extension (like 'cpp', 'hpp' or
+          'md'). Use '--list-languages' to show all supported language names and file
+          extensions.
+
+  -H, --highlight-line <N:M>
+          Highlight the specified line ranges with a different background color For example:
+            '--highlight-line 40' highlights line 40
+            '--highlight-line 30:40' highlights lines 30 to 40
+            '--highlight-line :40' highlights lines 1 to 40
+            '--highlight-line 40:' highlights lines 40 to the end of the file
+            '--highlight-line 30:+10' highlights lines 30 to 40
+
+      --file-name <name>
+          Specify the name to display for a file. Useful when piping data to bat from STDIN
+          when bat does not otherwise know the filename. Note that the provided file name is
+          also used for syntax detection.
+
+  -d, --diff
+          Only show lines that have been added/removed/modified with respect to the Git index.
+          Use --diff-context=N to control how much context you want to see.
+
+      --diff-context <N>
+          Include N lines of context around added/removed/modified lines when using '--diff'.
+
+      --tabs <T>
+          Set the tab width to T spaces. Use a width of 0 to pass tabs through directly
+
+      --wrap <mode>
+          Specify the text-wrapping mode (*auto*, never, character). The '--terminal-width'
+          option can be used in addition to control the output width.
+
+  -S, --chop-long-lines
+          Truncate all lines longer than screen width. Alias for '--wrap=never'.
+
+      --terminal-width <width>
+          Explicitly set the width of the terminal instead of determining it automatically. If
+          prefixed with '+' or '-', the value will be treated as an offset to the actual
+          terminal width. See also: '--wrap'.
+
+  -n, --number
+          Only show line numbers, no other decorations. This is an alias for '--style=numbers'
+
+      --color <when>
+          Specify when to use colored output. The automatic mode only enables colors if an
+          interactive terminal is detected - colors are automatically disabled if the output
+          goes to a pipe.
+          Possible values: *auto*, never, always.
+
+      --italic-text <when>
+          Specify when to use ANSI sequences for italic text in the output. Possible values:
+          always, *never*.
+
+      --decorations <when>
+          Specify when to use the decorations that have been specified via '--style'. The
+          automatic mode only enables decorations if an interactive terminal is detected.
+          Possible values: *auto*, never, always.
+
+  -f, --force-colorization
+          Alias for '--decorations=always --color=always'. This is useful if the output of bat
+          is piped to another program, but you want to keep the colorization/decorations.
+
+      --paging <when>
+          Specify when to use the pager. To disable the pager, use --paging=never' or its
+          alias,'-P'. To disable the pager permanently, set BAT_PAGING to 'never'. To control
+          which pager is used, see the '--pager' option. Possible values: *auto*, never,
+          always.
+
+      --pager <command>
+          Determine which pager is used. This option will override the PAGER and BAT_PAGER
+          environment variables. The default pager is 'less'. To control when the pager is
+          used, see the '--paging' option. Example: '--pager "less -RF"'.
+
+  -m, --map-syntax <glob:syntax>
+          Map a glob pattern to an existing syntax name. The glob pattern is matched on the
+          full path and the filename. For example, to highlight *.build files with the Python
+          syntax, use -m '*.build:Python'. To highlight files named '.myignore' with the Git
+          Ignore syntax, use -m '.myignore:Git Ignore'. Note that the right-hand side is the
+          *name* of the syntax, not a file extension.
+
+      --ignored-suffix <ignored-suffix>
+          Ignore extension. For example:
+            'bat --ignored-suffix ".dev" my_file.json.dev' will use JSON syntax, and ignore
+            '.dev'
+
+      --theme <theme>
+          Set the theme for syntax highlighting. Use '--list-themes' to see all available
+          themes. To set a default theme, add the '--theme="..."' option to the configuration
+          file or export the BAT_THEME environment variable (e.g.: export BAT_THEME="...").
+
+      --list-themes
+          Display a list of supported themes for syntax highlighting.
+
+      --style <components>
+          Configure which elements (line numbers, file headers, grid borders, Git
+          modifications, ..) to display in addition to the file contents. The argument is a
+          comma-separated list of components to display (e.g. 'numbers,changes,grid') or a
+          pre-defined style ('full'). To set a default style, add the '--style=".."' option to
+          the configuration file or export the BAT_STYLE environment variable (e.g.: export
+          BAT_STYLE="..").
+          
+          Possible values:
+          
+            * default: enables recommended style components (default).
+            * full: enables all available components.
+            * auto: same as 'default', unless the output is piped.
+            * plain: disables all available components.
+            * changes: show Git modification markers.
+            * header: alias for 'header-filename'.
+            * header-filename: show filenames before the content.
+            * header-filesize: show file sizes before the content.
+            * grid: vertical/horizontal lines to separate side bar
+                    and the header from the content.
+            * rule: horizontal lines to delimit files.
+            * numbers: show line numbers in the side bar.
+            * snip: draw separation lines between distinct line ranges.
+
+  -r, --line-range <N:M>
+          Only print the specified range of lines for each file. For example:
+            '--line-range 30:40' prints lines 30 to 40
+            '--line-range :40' prints lines 1 to 40
+            '--line-range 40:' prints lines 40 to the end of the file
+            '--line-range 40' only prints line 40
+            '--line-range 30:+10' prints lines 30 to 40
+
+  -L, --list-languages
+          Display a list of supported languages for syntax highlighting.
+
+  -u, --unbuffered
+          This option exists for POSIX-compliance reasons ('u' is for 'unbuffered'). The output
+          is always unbuffered - this option is simply ignored.
+
+      --diagnostic
+          Show diagnostic information for bug reports.
+
+      --acknowledgements
+          Show acknowledgements.
+
+  -h, --help
+          Print help (see a summary with '-h')
+
+  -V, --version
+          Print version
+
+You can use 'bat cache' to customize syntaxes and themes. See 'bat cache --help' for more
+information

data/lib/aia/external/fzf.rb

@@ -0,0 +1,147 @@
+# lib/aia/external/fzf.rb
+
+class AIA::External::Fzf < AIA::External::Tool
+  def initialize
+    super
+    @role = :selecter
+    @desc = 'Command-line fuzzy finder written in Go'
+    @url  = 'https://github.com/junegunn/fzf'
+  end
+
+
+  def command(options = {})
+    cd_command = "cd #{options[:prompt_dir]}"
+    find_command = "find . -name '*.txt'"
+    fzf_options = build_fzf_options(options[:fuzzy])
+    "#{cd_command} ; #{find_command} | fzf #{fzf_options}"
+  end
+
+  private
+
+  def build_fzf_options(fuzzy)
+    [
+      "--tabstop=2",
+      "--header='Prompt contents below'",
+      "--header-first",
+      "--prompt='Search term: '",
+      '--delimiter :',
+      "--preview 'ww {1}'",              # 'ww' from word_wrap gem
+      "--preview-window=down:50%:wrap"
+    ].tap { |opts| opts << "--exact" unless fuzzy }.join(' ')
+  end
+end
+
+__END__
+
+usage: fzf [options]
+
+  Search
+    -x, --extended         Extended-search mode
+                           (enabled by default; +x or --no-extended to disable)
+    -e, --exact            Enable Exact-match
+    -i                     Case-insensitive match (default: smart-case match)
+    +i                     Case-sensitive match
+    --scheme=SCHEME        Scoring scheme [default|path|history]
+    --literal              Do not normalize latin script letters before matching
+    -n, --nth=N[,..]       Comma-separated list of field index expressions
+                           for limiting search scope. Each can be a non-zero
+                           integer or a range expression ([BEGIN]..[END]).
+    --with-nth=N[,..]      Transform the presentation of each line using
+                           field index expressions
+    -d, --delimiter=STR    Field delimiter regex (default: AWK-style)
+    +s, --no-sort          Do not sort the result
+    --track                Track the current selection when the result is updated
+    --tac                  Reverse the order of the input
+    --disabled             Do not perform search
+    --tiebreak=CRI[,..]    Comma-separated list of sort criteria to apply
+                           when the scores are tied [length|chunk|begin|end|index]
+                           (default: length)
+
+  Interface
+    -m, --multi[=MAX]      Enable multi-select with tab/shift-tab
+    --no-mouse             Disable mouse
+    --bind=KEYBINDS        Custom key bindings. Refer to the man page.
+    --cycle                Enable cyclic scroll
+    --keep-right           Keep the right end of the line visible on overflow
+    --scroll-off=LINES     Number of screen lines to keep above or below when
+                           scrolling to the top or to the bottom (default: 0)
+    --no-hscroll           Disable horizontal scroll
+    --hscroll-off=COLS     Number of screen columns to keep to the right of the
+                           highlighted substring (default: 10)
+    --filepath-word        Make word-wise movements respect path separators
+    --jump-labels=CHARS    Label characters for jump and jump-accept
+
+  Layout
+    --height=[~]HEIGHT[%]  Display fzf window below the cursor with the given
+                           height instead of using fullscreen.
+                           If prefixed with '~', fzf will determine the height
+                           according to the input size.
+    --min-height=HEIGHT    Minimum height when --height is given in percent
+                           (default: 10)
+    --layout=LAYOUT        Choose layout: [default|reverse|reverse-list]
+    --border[=STYLE]       Draw border around the finder
+                           [rounded|sharp|bold|block|thinblock|double|horizontal|vertical|
+                            top|bottom|left|right|none] (default: rounded)
+    --border-label=LABEL   Label to print on the border
+    --border-label-pos=COL Position of the border label
+                           [POSITIVE_INTEGER: columns from left|
+                            NEGATIVE_INTEGER: columns from right][:bottom]
+                           (default: 0 or center)
+    --margin=MARGIN        Screen margin (TRBL | TB,RL | T,RL,B | T,R,B,L)
+    --padding=PADDING      Padding inside border (TRBL | TB,RL | T,RL,B | T,R,B,L)
+    --info=STYLE           Finder info style
+                           [default|right|hidden|inline[:SEPARATOR]|inline-right]
+    --separator=STR        String to form horizontal separator on info line
+    --no-separator         Hide info line separator
+    --scrollbar[=C1[C2]]   Scrollbar character(s) (each for main and preview window)
+    --no-scrollbar         Hide scrollbar
+    --prompt=STR           Input prompt (default: '> ')
+    --pointer=STR          Pointer to the current line (default: '>')
+    --marker=STR           Multi-select marker (default: '>')
+    --header=STR           String to print as header
+    --header-lines=N       The first N lines of the input are treated as header
+    --header-first         Print header before the prompt line
+    --ellipsis=STR         Ellipsis to show when line is truncated (default: '..')
+
+  Display
+    --ansi                 Enable processing of ANSI color codes
+    --tabstop=SPACES       Number of spaces for a tab character (default: 8)
+    --color=COLSPEC        Base scheme (dark|light|16|bw) and/or custom colors
+    --no-bold              Do not use bold text
+
+  History
+    --history=FILE         History file
+    --history-size=N       Maximum number of history entries (default: 1000)
+
+  Preview
+    --preview=COMMAND      Command to preview highlighted line ({})
+    --preview-window=OPT   Preview window layout (default: right:50%)
+                           [up|down|left|right][,SIZE[%]]
+                           [,[no]wrap][,[no]cycle][,[no]follow][,[no]hidden]
+                           [,border-BORDER_OPT]
+                           [,+SCROLL[OFFSETS][/DENOM]][,~HEADER_LINES]
+                           [,default][,<SIZE_THRESHOLD(ALTERNATIVE_LAYOUT)]
+    --preview-label=LABEL
+    --preview-label-pos=N  Same as --border-label and --border-label-pos,
+                           but for preview window
+
+  Scripting
+    -q, --query=STR        Start the finder with the given query
+    -1, --select-1         Automatically select the only match
+    -0, --exit-0           Exit immediately when there's no match
+    -f, --filter=STR       Filter mode. Do not start interactive finder.
+    --print-query          Print query as the first line
+    --expect=KEYS          Comma-separated list of keys to complete fzf
+    --read0                Read input delimited by ASCII NUL characters
+    --print0               Print output delimited by ASCII NUL characters
+    --sync                 Synchronous search for multi-staged filtering
+    --listen[=[ADDR:]PORT] Start HTTP server to receive actions (POST /)
+                           (To allow remote process execution, use --listen-unsafe)
+    --version              Display version information and exit
+
+  Environment variables
+    FZF_DEFAULT_COMMAND    Default command to use when input is tty
+    FZF_DEFAULT_OPTS       Default options
+                           (e.g. '--layout=reverse --inline-info')
+    FZF_API_KEY            X-API-Key header for HTTP server (--listen)
+

data/lib/aia/external/glow.rb

@@ -0,0 +1,37 @@
+# lib/aia/external/glow.rb
+
+class AIA::External::Glow < AIA::External::Tool
+  def initialize
+    super
+    @role = :render
+    @desc = 'Render markdown on the CLI'
+    @url  = 'https://github.com/charmbracelet/glow'
+  end
+end
+
+
+__END__
+                                                                              
+  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/lib/aia/external/mods.rb

@@ -0,0 +1,57 @@
+# lib/aia/external/mods.rb
+
+class AIA::External::Mods < AIA::External::Tool
+  def initialize
+    super
+    @role = :search
+    @desc = 'AI on the command-line'
+    @url  = 'https://github.com/charmbracelet/mods'
+  end
+
+  def command(extra_options = [])
+    model = ENV['MODS_MODEL'] || 'gpt-4-1106-preview'
+    ai_default_opts = "-m #{model} --no-limit -f"
+    "#{name} #{ai_default_opts} #{extra_options.join(' ')}"
+  end
+end
+
+__END__
+
+GPT on the command line. Built for pipelines.
+
+Usage:
+  mods [OPTIONS] [PREFIX TERM]
+
+Options:
+  -m, --model                                  Default model (gpt-3.5-turbo, gpt-4, ggml-gpt4all-j...).
+  -a, --api                                    OpenAI compatible REST API (openai, localai).
+  -x, --http-proxy                             HTTP proxy to use for API requests.
+  -f, --format                                 Ask for the response to be formatted as markdown unless otherwise set.
+  -r, --raw                                    Render output as raw text when connected to a TTY.
+  -P, --prompt                                 Include the prompt from the arguments and stdin, truncate stdin to specified number of lines.
+  -p, --prompt-args                            Include the prompt from the arguments in the response.
+  -c, --continue                               Continue from the last response or a given save title.
+  -C, --continue-last                          Continue from the last response.
+  -l, --list                                   Lists saved conversations.
+  -t, --title                                  Saves the current conversation with the given title.
+  -d, --delete                                 Deletes a saved conversation with the given title or ID.
+  -s, --show                                   Show a saved conversation with the given title or ID.
+  -S, --show-last                              Show a the last saved conversation.
+  -q, --quiet                                  Quiet mode (hide the spinner while loading and stderr messages for success).
+  -h, --help                                   Show help and exit.
+  -v, --version                                Show version and exit.
+  --max-retries                                Maximum number of times to retry API calls.
+  --no-limit                                   Turn off the client-side limit on the size of the input into the model.
+  --max-tokens                                 Maximum number of tokens in response.
+  --temp                                       Temperature (randomness) of results, from 0.0 to 2.0.
+  --topp                                       TopP, an alternative to temperature that narrows response, from 0.0 to 1.0.
+  --fanciness                                  Your desired level of fanciness.
+  --status-text                                Text to show while generating.
+  --no-cache                                   Disables caching of the prompt/response.
+  --reset-settings                             Backup your old settings file and reset everything to the defaults.
+  --settings                                   Open settings in your $EDITOR.
+  --dirs                                       Print the directories in which mods store its data
+
+Example:
+  # Editorialize your video files
+  ls ~/vids | mods -f "summarize each of these titles, group them by decade" | glow