aia 0.0.4 → 0.3.0

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