quickquestion 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c713eb0d5a8fce0fb8b796e7984b0c2c27e34c89fda6cffac8ce1f8d6d6fce6d
+  data.tar.gz: 3016f0aa46f0507982cbc190d55a2f9a2f90881df176a6ce750c51ebf943e604
+SHA512:
+  metadata.gz: b2e252409b9ad5cd35b451d795c47b0ec642443b8845d162b0017caa3e6a90001a2c580dce94f484d77b2fb6a7f383fa9b134286c59e1ff7136d7ce6cb00a90e
+  data.tar.gz: 66b4afda992913ae14816a70ece7ad905cb0d691db997aaff79d2bac9ce9e1ca07e073aed57fb474efdf53a057cbbc21628730732526cecf36a4d60f91dfe710

data/.gitignore

@@ -0,0 +1 @@
+*.gem

data/.ruby-version

@@ -0,0 +1 @@
+3.3.1

data/Gemfile

@@ -0,0 +1,16 @@
+source "https://rubygems.org"
+
+gemspec
+
+group :development do
+  gem "byebug"
+  gem "rb-readline"
+  gem "standard"
+  gem "standard-performance"
+end
+
+# runtime dependencies
+gem "claude-ruby"
+gem "sequel"
+gem "sqlite3"
+gem "xdg"

data/Gemfile.lock

@@ -0,0 +1,104 @@
+PATH
+  remote: .
+  specs:
+    quickquestion (0.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.2)
+    bigdecimal (3.1.8)
+    byebug (11.1.3)
+    claude-ruby (0.4.0)
+      httparty
+    csv (3.3.0)
+    httparty (0.22.0)
+      csv
+      mini_mime (>= 1.0.0)
+      multi_xml (>= 0.5.2)
+    json (2.7.2)
+    language_server-protocol (3.17.0.3)
+    lint_roller (1.1.0)
+    mini_mime (1.1.5)
+    multi_xml (0.7.1)
+      bigdecimal (~> 3.1)
+    parallel (1.26.2)
+    parser (3.3.4.2)
+      ast (~> 2.4.1)
+      racc
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rb-readline (0.5.5)
+    regexp_parser (2.9.2)
+    rexml (3.3.5)
+      strscan
+    rubocop (1.64.1)
+      json (~> 2.3)
+      language_server-protocol (>= 3.17.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.32.0)
+      parser (>= 3.3.1.0)
+    rubocop-performance (1.21.1)
+      rubocop (>= 1.48.1, < 2.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
+    ruby-progressbar (1.13.0)
+    sequel (5.83.1)
+      bigdecimal
+    sqlite3 (2.0.3-aarch64-linux-gnu)
+    sqlite3 (2.0.3-aarch64-linux-musl)
+    sqlite3 (2.0.3-arm-linux-gnu)
+    sqlite3 (2.0.3-arm-linux-musl)
+    sqlite3 (2.0.3-arm64-darwin)
+    sqlite3 (2.0.3-x86-linux-gnu)
+    sqlite3 (2.0.3-x86-linux-musl)
+    sqlite3 (2.0.3-x86_64-darwin)
+    sqlite3 (2.0.3-x86_64-linux-gnu)
+    sqlite3 (2.0.3-x86_64-linux-musl)
+    standard (1.39.2)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.64.0)
+      standard-custom (~> 1.0.0)
+      standard-performance (~> 1.4)
+    standard-custom (1.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.50)
+    standard-performance (1.4.0)
+      lint_roller (~> 1.1)
+      rubocop-performance (~> 1.21.0)
+    strscan (3.1.0)
+    unicode-display_width (2.5.0)
+    xdg (8.5.0)
+
+PLATFORMS
+  aarch64-linux-gnu
+  aarch64-linux-musl
+  arm-linux-gnu
+  arm-linux-musl
+  arm64-darwin
+  x86-linux-gnu
+  x86-linux-musl
+  x86_64-darwin
+  x86_64-linux-gnu
+  x86_64-linux-musl
+
+DEPENDENCIES
+  byebug
+  claude-ruby
+  quickquestion!
+  rb-readline
+  sequel
+  sqlite3
+  standard
+  standard-performance
+  xdg
+
+BUNDLED WITH
+   2.5.9

data/README.md

@@ -0,0 +1,54 @@
+# Quick Question...
+
+Ask Claude a quick question from the CLI with `qq`:
+
+    $ qq how do I tell if I'm using an rbenv ruby or the system ruby
+    $ cat question.txt | qq
+    $ echo "question" | qq
+    
+    # or just qq alone for a prompt with readline:
+    $ qq
+    > is rbenv or chruby more reliable?
+
+Set `ANTHROPIC_API_KEY` env var to your [API key](https://console.anthropic.com/account/keys).
+
+## Expectations
+
+`qq` is a quick hack.
+There are currently no options.
+
+Your questions and answers are logged to `~/.config/qq/log.sqlite`
+(or set [XDG_CCONFIG_HOME](https://specifications.freedesktop.org/basedir-spec/latest/#variables)).
+
+## Possible TODOs
+
+ * Handle ctrl-c without traceback
+ * Prompt customization.
+ * Use `qc` to have a quick conversation (or `quick continue`), which picks up from the last `qq` if it happened in the last 15m.
+   (This uses the logs in `~/.config/qq/log.sqlite`.)
+ * Prompt for a response in tags. Use `stop_sequences` to end abruptly.
+ * https://docs.anthropic.com/en/docs/build-with-claude/prompt-caching
+
+## Development
+
+    # run local
+    ruby -Ilib bin/qq
+
+    # irb with gem loaded
+    irb -Ilib -rqq
+
+## Local use
+
+    # after build
+    gem install ./qq-<tab>
+
+# Release
+
+    # rm old gems
+    rm *.gem
+
+    # set version in qq.gemspec
+
+    # to make the .gem
+    gem build
+

data/bin/qq

@@ -0,0 +1,23 @@
+#!/usr/bin/env ruby
+
+# Ruby 3.4 will move csv out of stdlib; httparty 0.22.0 depends on it without a version, bundler is
+# confused/mad there is a stdlib and gem version at the same time, warning:
+#     WARN: Unresolved or ambiguous specs during Gem::Specification.reset:
+#           csv (>= 0)
+#           Available/installed versions of this gem:
+#           - 3.3.0
+#           - 3.2.8
+#     WARN: Clearing out unresolved specs. Try 'gem cleanup <gem>'
+#     Please report a bug if this causes problems.
+# requiring csv here silences it and I refuse to keep digging
+require "csv"
+
+require "bundler/setup"
+
+require "readline"
+require "quickquestion"
+
+input = ARGV.any? ? ARGV.join(' ') : ($stdin.tty? ? Readline.readline("> ", true) : $stdin.read)
+exit if input.nil? || input.strip.empty?
+response = QuickQuestion.query(input)
+puts response

data/lib/migration/20240811233902_create_queries_table.rb

@@ -0,0 +1,17 @@
+Sequel.migration do
+  up do
+    create_table(:queries) do
+      primary_key :id
+      DateTime :at, null: false
+      String :query, null: false
+      String :response, null: false
+      Integer :input_tokens, null: false
+      Integer :output_tokens, null: false
+      BigDecimal :cost, size: [10, 4], null: false
+    end
+  end
+
+  down do
+    drop_table(:queries)
+  end
+end

data/lib/quickquestion.rb

@@ -0,0 +1,58 @@
+require "claude/client"
+require "sequel"
+require "fileutils"
+require "xdg"
+require "bigdecimal"
+
+module QuickQuestion
+  VERSION = "0.1.0"
+  DB_PATH = File.join(XDG::Config.new.home, "qq/log.sqlite3")
+
+  def self.setup_db
+    FileUtils.mkdir_p(File.dirname(DB_PATH))
+    @db ||= Sequel.connect("sqlite://#{DB_PATH}")
+
+    Sequel.extension :migration
+    Sequel::TimestampMigrator.run(@db, File.join(File.dirname(__FILE__), "migration"))
+
+    @db
+  end
+
+  def self.db
+    @db ||= setup_db
+  end
+
+  def self.query(input)
+    api_key = ENV["ANTHROPIC_API_KEY"]
+    raise "ANTHROPIC_API_KEY environment variable is not set" if api_key.nil? || api_key.empty?
+
+    claude = Claude::Client.new(api_key)
+    prompt = "Give concise expert answers. Answer calmly and directly. If unsure, answer about the most common case. Never repeat questions or introduce your answer. If giving code samples, do not explain unless explicitly asked."
+    messages = claude.user_message(prompt + "\n" + input)
+    response = claude.messages(messages, model: Claude::Model::CLAUDE_SONNET_LATEST)
+    text = claude.parse_response(response)
+    usage = response["usage"]
+    input_tokens = usage["input_tokens"]
+    output_tokens = usage["output_tokens"]
+    cost = calculate_cost(usage)
+    log_query(input, text, input_tokens, output_tokens, cost)
+    "#{text} (Cost: $#{cost.truncate(4).to_s("F")})"
+  end
+
+  def self.calculate_cost(usage)
+    input_tokens = BigDecimal(usage["input_tokens"])
+    output_tokens = BigDecimal(usage["output_tokens"])
+    (input_tokens * 3 + output_tokens * 15) / BigDecimal("1_000_000")
+  end
+
+  def self.log_query(query, response, input_tokens, output_tokens, cost)
+    db[:queries].insert(
+      at: Time.now.utc,
+      query: query,
+      response: response,
+      input_tokens: input_tokens,
+      output_tokens: output_tokens,
+      cost: cost
+    )
+  end
+end

data/quickquestion.gemspec

@@ -0,0 +1,25 @@
+require_relative "lib/quickquestion"
+
+Gem::Specification.new do |spec|
+  spec.name = "quickquestion"
+  spec.version = QuickQuestion::VERSION
+  spec.required_ruby_version = ">= 3.0.0"
+  spec.summary = "Ask LLMs quick questions"
+  spec.description = "A command-line tool to quickly ask questions to LLMs"
+  spec.authors = ["Peter Bhat Harkins"]
+  spec.email = ["peter@push.cx"]
+  spec.license = "Nonstandard" # yeah I dunno
+
+  spec.homepage = "https://push.cx/qq"
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/pushcx/quickquestion"
+
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      f.start_with?("test/", "spec/")
+    end
+  end
+  spec.bindir = "bin"
+  spec.executables = ["qq"]
+  spec.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,56 @@
+--- !ruby/object:Gem::Specification
+name: quickquestion
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Peter Bhat Harkins
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2024-11-15 00:00:00.000000000 Z
+dependencies: []
+description: A command-line tool to quickly ask questions to LLMs
+email:
+- peter@push.cx
+executables:
+- qq
+extensions: []
+extra_rdoc_files: []
+files:
+- ".git-blame-ignore-revs"
+- ".gitignore"
+- ".ruby-version"
+- Gemfile
+- Gemfile.lock
+- README.md
+- bin/qq
+- lib/migration/20240811233902_create_queries_table.rb
+- lib/quickquestion.rb
+- quickquestion.gemspec
+homepage: https://push.cx/qq
+licenses:
+- Nonstandard
+metadata:
+  homepage_uri: https://push.cx/qq
+  source_code_uri: https://github.com/pushcx/quickquestion
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.20
+signing_key:
+specification_version: 4
+summary: Ask LLMs quick questions
+test_files: []