llm-shell 0.3.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2dfeeceab3ca11d0c832f8114b903d83791e237fabf4bb2dd0ce4d840be0e1ee
-  data.tar.gz: 119072ae06110415da13cee558ce8cdfe6613b4ad0198e91d207b91235824e5d
+  metadata.gz: f6aec859f4eb4fd9bfc722da0f0ccbaada65932b56bbd5d118f8131be32097e5
+  data.tar.gz: 0156acf8d3efbec33ce61aab82e5cc90f2618888b7cce6fa181c5de5b11b591c
 SHA512:
-  metadata.gz: 391dbf0bc2937545a475aaade248ebdfe495fd88c61ecd4691623220276f35dca1d438b55dbaf20826e30e554013493ca98044d40816396a45f9f3d5e89d678a
-  data.tar.gz: 63f8201b0aebd0e260788df46b90e96afdd4442f1b27bf9d4e025a6c6b6c6ca2d2338b6140fd69d616cc121cd8fa91bd1e71b3d9043e143af78a0494041ea563
+  metadata.gz: bdc7e09ec212ee04005bf636caa64abbfdbb087a6d20506402aaf81703806d4c3ddf7611f0c4dc61eedaa7711f6fe50880be0691a07181cb9d582e19fbcf2ba8
+  data.tar.gz: 7ce76e58b455c55ee94d52b2913396e514d2b808c0fa00ac57c5dff34b499c4cf1def4f3acc398ddfd602cb9f202a3261f8c51ea6012c89853c3a9d79991f9d5

data/README.md

@@ -23,6 +23,7 @@ it in action!
 #### Shell
 
 - 🤖 Builtin auto-complete powered by Readline
+- 🎨 Builtin syntax highlighting powered by Coderay
 - 📄 Deploys the less pager for long outputs
 - 📝 Advanced Markdown formatting and output
 
@@ -84,6 +85,7 @@ command for a realistic example:
 
 ```ruby
 LLM.command "say-hello" do |cmd|
+  cmd.description "Say hello to somebody"
   cmd.define do |name|
     io.rewind.print "Hello #{name}!"
   end
@@ -126,13 +128,13 @@ tools:
 
 ```bash
 Usage: llm-shell [OPTIONS]
-    -p, --provider NAME              Required. Options: gemini, openai, anthropic, or ollama.
-    -k, --key [KEY]                  Optional. Required by gemini, openai, and anthropic.
-    -m, --model [MODEL]              Optional. The name of a model.
-    -h, --host [HOST]                Optional. Sometimes required by ollama.
-    -o, --port [PORT]                Optional. Sometimes required by ollama.
-    -f, --files [GLOB]               Optional. Glob pattern(s) separated by a comma.
-    -t, --tools [TOOLS]              Optional. One or more tool names to load automatically.
+    -p, --provider NAME      Required. Options: gemini, openai, anthropic, ollama or llamacpp.
+    -k, --key [KEY]          Optional. Required by gemini, openai, and anthropic.
+    -m, --model [MODEL]      Optional. The name of a model.
+    -h, --host [HOST]        Optional. Sometimes required by ollama.
+    -o, --port [PORT]        Optional. Sometimes required by ollama.
+    -f, --files [GLOB]       Optional. Glob pattern(s) separated by a comma.
+    -t, --tools [TOOLS]      Optional. One or more tool names to load automatically.
 ```
 
 ## Install

data/lib/llm/shell/command.rb

@@ -13,6 +13,7 @@ class LLM::Shell
     # Set or get the command name
     # @param [String, nil] name
     #  The name of the command
+    # @return [String]
     def name(name = nil)
       if name
         @name = name
@@ -21,6 +22,19 @@ class LLM::Shell
       end
     end
 
+    ##
+    # Set or get the command description
+    # @param [String, nil] desc
+    #  The description of the command
+    # @return [String]
+    def description(desc = nil)
+      if desc
+        @description = desc
+      else
+        @description
+      end
+    end
+
     ##
     # Setup the command context
     # @return [void]

data/lib/llm/shell/commands/import_file.rb

@@ -12,6 +12,10 @@ class LLM::Shell::Command
       Dir["#{path}*"]
     end
 
+    ##
+    # @param [LLM::Shell::Context] context
+    #  The context of the command
+    # @return [LLM::Shell::Command::ImportFile]
     def initialize(context)
       @context = context
     end
@@ -35,6 +39,7 @@ class LLM::Shell::Command
   end
 
   LLM.command "import-file" do |cmd|
+    cmd.description "Share one or more files with the LLM"
     cmd.register ImportFile
   end
 end

data/lib/llm/shell/markdown.rb

@@ -3,6 +3,7 @@
 class LLM::Shell
   class Markdown
     require "kramdown"
+    require "coderay"
 
     ##
     # @param [String] text
@@ -37,7 +38,18 @@ class LLM::Shell
         Paint[node.children.map { visit(_1) }.join, :bold]
       when :br
         "\n"
-      when :text, :codespan
+      when :codespan, :codeblock
+        lines = node.value.each_line.to_a
+        lang  = lines[0].strip
+        code  = lines[1..].join
+        if lines.size == 1
+          Paint[node.value, :italic]
+        else
+          ["\n", Paint[">>> #{lang}", :blue, :bold],
+           "\n\n", coderay(code, lang),
+           "\n", Paint["<<< #{lang}", :blue, :bold]].join
+        end
+      when :text
         node.value
       else
         node.children.map { visit(_1) }.join
@@ -58,5 +70,12 @@ class LLM::Shell
         .gsub(/\A<think>[\n]*<\/think>(?:\n)/, "")
         .gsub(/\A\n{2,}/, "")
     end
+
+    def coderay(code, lang)
+      CodeRay.scan(code, lang).terminal
+    rescue ArgumentError
+      lang = "text"
+      retry
+    end
   end
 end

data/lib/llm/shell/version.rb

@@ -4,5 +4,5 @@ module LLM
 end unless defined?(LLM)
 
 class LLM::Shell
-  VERSION = "0.3.0"
+  VERSION = "0.4.1"
 end

data/libexec/llm-shell/shell

@@ -17,7 +17,7 @@ end
 def option_parser
   OptionParser.new do |o|
     o.banner = "Usage: llm-shell [OPTIONS]"
-    o.on("-p PROVIDER", "--provider NAME", "Required. Options: gemini, openai, anthropic, or ollama.", String)
+    o.on("-p PROVIDER", "--provider NAME", "Required. Options: gemini, openai, anthropic, ollama or llamacpp.", String)
     o.on("-k [KEY]", "--key [KEY]", "Optional. Required by gemini, openai, and anthropic.", String)
     o.on("-m [MODEL]", "--model [MODEL]", "Optional. The name of a model.", Array)
     o.on("-h [HOST]", "--host [HOST]", "Optional. Sometimes required by ollama.", String)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: llm-shell
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.1
 platform: ruby
 authors:
 - Antar Azri
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-05-10 00:00:00.000000000 Z
+date: 2025-05-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: llm.rb
@@ -53,6 +53,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: coderay
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement