rubycode 0.1.4 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 38eb208124cc78e03b6a8fb2778309dc17999ed1ab50270fbbfc3635f5d144d2
-  data.tar.gz: c02ee8d739bf3162d2e3e2fb5e16adcd00d9a373b3223e6e3d2ae6694f75c22d
+  metadata.gz: 50f110cea87f9ae98d0613a54a8feec231d1f050c62382b42428d4233bf871c0
+  data.tar.gz: d9a0171878bdcbad488afd81146a6887a2ea64a8d361d5932f9e5e162202d36e
 SHA512:
-  metadata.gz: 29a2f388ff00077112e5f3697a1fbca342ba5a9974bf7b306c862f4b97f78585c3357366c6980ca5c71c21944e191243ac4e84e59f6451492e140fb711d15314
-  data.tar.gz: bc30616c062dd24865f4ec9d2c93cae55569dec5d17c0648d39d6c6aa3059ca91d736b7867e4f0b7015de514182d145b47a5b93e7b297832134f26e922e6e93b
+  metadata.gz: eecbe47b72a9ea6b36c905f5b8560a6f8611c381ec3de35d4a50db991dc6576442d04604c51f87ee45f253862c7771cfd70e644833f317d137c33e9d1f40bdf2
+  data.tar.gz: 5c15e211f5605d8b986b49704b6d55ac3764364758efaca44d46f552a61ef6eecc993a8bf24eed55452776136859c361f91c1226c94cda7a32edf3f4ecc4c7d9

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 ## [Unreleased]
 
+## [0.1.5] - 2026-03-08
+
+### Added
+- **CLI Executable**: `rubycode_client` command for interactive chat after gem installation
+
+### Changed
+- **README**: Reorganized Quick Start section to prioritize CLI usage
+- **Testing**: Updated documentation to use `bin/test` command
+
 ## [0.1.4] - 2026-03-07
 
 ### Added

data/README.md

@@ -59,23 +59,48 @@ Then execute:
 bundle install
 ```
 
-## Usage
+## Quick Start
 
-### Basic Usage
+### Interactive CLI
 
-#### Interactive CLI (Recommended)
+After installing the gem, run the interactive client:
 
 ```bash
-rubycode
+rubycode_client
 ```
 
-The first time you run RubyCode, an interactive setup wizard will guide you through:
+The first time you run it, an interactive setup wizard will guide you through:
 1. Selecting your LLM provider (Ollama Cloud, DeepSeek, Gemini, OpenAI, or OpenRouter)
 2. Choosing a model
 3. Entering API keys (saved securely with encryption)
 
 Your configuration is automatically saved and reloaded on subsequent runs.
 
+### Programmatic Usage
+
+You can also use RubyCode in your Ruby projects:
+
+```ruby
+require "rubycode"
+
+# Configure the LLM adapter
+RubyCode.configure do |config|
+  config.adapter = :ollama
+  config.url = "https://api.ollama.com"
+  config.model = "qwen3-coder:480b-cloud"
+  config.root_path = Dir.pwd
+end
+
+# Create a client and ask a question
+client = RubyCode::Client.new
+response = client.ask(prompt: "Find the User model in the codebase")
+puts response
+```
+
+## Usage
+
+### Basic Usage
+
 #### Programmatic Usage
 
 ```ruby
@@ -163,6 +188,11 @@ export EXA_API_KEY=your_api_key_here
 export BRAVE_API_KEY=your_api_key_here
 ```
 
+### New in 0.1.5
+
+- **CLI Executable**: `rubycode_client` command for interactive chat after gem installation
+- **Improved Documentation**: Reorganized Quick Start section with CLI-first approach
+
 ### New in 0.1.4
 
 - **Bug Fix**: Agent now properly stops when `done` tool is called, even if tool execution fails
@@ -186,10 +216,10 @@ After checking out the repo, run `bundle install` to install dependencies.
 
 ```bash
 # Run all tests
-bundle exec rake test
+bin/test
 
-# Run tests without warnings
-bundle exec rake test 2>/dev/null
+# Or with rake
+bundle exec rake test
 
 # Run specific test file
 bundle exec rake test TEST=test/test_adapters.rb

data/exe/rubycode_client

@@ -0,0 +1,274 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/rubycode"
+require "tty-prompt"
+
+prompt = TTY::Prompt.new
+
+# Setup wizard for first-time configuration or reconfiguration
+def setup_wizard(prompt)
+  puts RubyCode::Views::Cli::SetupTitle.build
+
+  adapter = select_adapter(prompt)
+  model = select_model_for_adapter(prompt, adapter)
+  url = get_url_for_adapter(prompt, adapter)
+
+  configure_adapter_api_key(prompt, adapter) if adapter_requires_key?(adapter)
+  configure_exa_api_key(prompt) if prompt.yes?(I18n.t("rubycode.setup.configure_exa"), default: false)
+
+  save_and_return_config(adapter, model, url)
+end
+
+def select_adapter(prompt)
+  prompt.select(I18n.t("rubycode.setup.adapter_prompt"), {
+                  I18n.t("rubycode.adapters.ollama.name") => :ollama,
+                  I18n.t("rubycode.adapters.deepseek.name") => :deepseek,
+                  I18n.t("rubycode.adapters.gemini.name") => :gemini,
+                  I18n.t("rubycode.adapters.openai.name") => :openai,
+                  I18n.t("rubycode.adapters.openrouter.name") => :openrouter
+                })
+end
+
+def select_model_for_adapter(prompt, adapter)
+  models = I18n.t("rubycode.models.#{adapter}")
+  choices = {}
+  models.each do |key, model_data|
+    # Skip the :default key which is just a string
+    next if %i[default].include?(key) || ["default"].include?(key)
+    # Skip if model_data is not a hash (defensive)
+    next unless model_data.is_a?(Hash)
+
+    label = model_data[:label] || model_data["label"]
+    name = model_data[:name] || model_data["name"]
+    choices[label] = name
+  end
+  prompt.select(I18n.t("rubycode.setup.model_prompt"), choices)
+end
+
+def get_url_for_adapter(prompt, adapter)
+  case adapter
+  when :ollama
+    prompt.ask(I18n.t("rubycode.setup.url_prompt"), default: "https://api.ollama.com")
+  when :deepseek
+    "https://api.deepseek.com/v1/chat/completions"
+  when :gemini
+    "https://generativelanguage.googleapis.com/v1beta/models"
+  when :openai
+    "https://api.openai.com/v1/chat/completions"
+  when :openrouter
+    "https://openrouter.ai/api/v1/chat/completions"
+  end
+end
+
+def adapter_requires_key?(adapter)
+  I18n.t("rubycode.adapters.#{adapter}")[:requires_key]
+end
+
+def configure_adapter_api_key(prompt, adapter)
+  env_var_name = "#{adapter.to_s.upcase}_API_KEY"
+  saved_exists = RubyCode::Models::ApiKey.key_exists?(adapter: adapter)
+  env_exists = ENV.fetch(env_var_name, nil)
+
+  if saved_exists
+    handle_existing_saved_key(prompt, adapter)
+  elsif env_exists
+    handle_existing_env_key(prompt, adapter, env_var_name)
+  else
+    prompt_for_required_key(prompt, adapter)
+  end
+end
+
+def handle_existing_saved_key(prompt, adapter)
+  use_saved = prompt.yes?(I18n.t("rubycode.setup.use_saved_api_key", adapter: adapter.to_s.upcase), default: true)
+  return if use_saved
+
+  new_key = prompt.mask("#{I18n.t("rubycode.setup.api_key_prompt", adapter: adapter.to_s.upcase)} " \
+                        "#{I18n.t("rubycode.setup.api_key_optional")}")
+  RubyCode::Models::ApiKey.save_key(adapter: adapter, api_key: new_key) if new_key && !new_key.empty?
+end
+
+def handle_existing_env_key(prompt, adapter, env_var_name)
+  save_to_db = prompt.yes?(I18n.t("rubycode.setup.save_env_key_to_db", adapter: adapter.to_s.upcase), default: true)
+  RubyCode::Models::ApiKey.save_key(adapter: adapter, api_key: ENV.fetch(env_var_name, nil)) if save_to_db
+end
+
+def prompt_for_required_key(prompt, adapter)
+  puts RubyCode::Views::Cli::ApiKeyMissing.build(adapter: adapter)
+  api_key = prompt.mask(I18n.t("rubycode.setup.api_key_prompt", adapter: adapter.to_s.upcase))
+
+  if api_key.nil? || api_key.empty?
+    puts "\n#{I18n.t("rubycode.setup.api_key_required")}\n"
+    exit 1
+  end
+
+  RubyCode::Models::ApiKey.save_key(adapter: adapter, api_key: api_key)
+end
+
+def configure_exa_api_key(prompt)
+  saved_exists = RubyCode::Models::ApiKey.key_exists?(adapter: :exa)
+  env_exists = ENV.fetch("EXA_API_KEY", nil)
+
+  if saved_exists
+    handle_existing_saved_key(prompt, :exa)
+  elsif env_exists
+    handle_exa_env_key(prompt)
+  else
+    prompt_for_optional_exa_key(prompt)
+  end
+end
+
+def handle_exa_env_key(prompt)
+  save_to_db = prompt.yes?(I18n.t("rubycode.setup.save_env_key_to_db", adapter: "EXA"), default: true)
+  RubyCode::Models::ApiKey.save_key(adapter: :exa, api_key: ENV.fetch("EXA_API_KEY", nil)) if save_to_db
+end
+
+def prompt_for_optional_exa_key(prompt)
+  exa_key = prompt.mask("#{I18n.t("rubycode.setup.api_key_prompt", adapter: "EXA")} " \
+                        "#{I18n.t("rubycode.setup.api_key_optional")}")
+  RubyCode::Models::ApiKey.save_key(adapter: :exa, api_key: exa_key) if exa_key && !exa_key.empty?
+end
+
+def save_and_return_config(adapter, model, url)
+  config = { adapter: adapter, model: model, url: url }
+  RubyCode::ConfigManager.save(config)
+  puts RubyCode::Views::Cli::ConfigSaved.build
+  config
+end
+
+# Load or setup configuration
+if RubyCode::ConfigManager.exists?
+  saved_config = RubyCode::ConfigManager.load
+  use_saved = prompt.yes?(I18n.t("rubycode.setup.use_saved",
+                                 adapter: saved_config[:adapter],
+                                 model: saved_config[:model]),
+                          default: true)
+  config = use_saved ? saved_config : setup_wizard(prompt)
+else
+  puts RubyCode::Views::Cli::FirstTimeSetup.build
+  config = setup_wizard(prompt)
+end
+adapter = config[:adapter]
+model = config[:model]
+url = config[:url]
+
+puts "\n#{RubyCode::Views::Welcome.build}"
+
+directory = prompt.ask("What directory do you want to work on?") do |q|
+  q.default Dir.pwd
+  q.required false
+end
+directory = Dir.pwd if directory.nil? || directory.empty?
+
+full_path = File.expand_path(directory)
+
+unless Dir.exist?(full_path)
+  puts RubyCode::Views::Cli::ErrorMessage.build(message: "Directory '#{full_path}' does not exist!")
+  exit 1
+end
+
+RubyCode.configure do |config|
+  config.adapter = adapter
+  config.url = url
+  config.model = model
+  config.root_path = full_path
+end
+
+puts RubyCode::Views::Cli::ConfigurationTable.build(
+  adapter: adapter,
+  model: model,
+  directory: full_path
+)
+
+# Ensure database is connected before checking for API keys
+RubyCode::Database.connect
+
+# Check if adapter requires API key and ensure it's available
+adapter_info = I18n.t("rubycode.adapters.#{adapter}")
+if adapter_info[:requires_key]
+  env_var_name = "#{adapter.to_s.upcase}_API_KEY"
+  db_key_exists = RubyCode::Models::ApiKey.key_exists?(adapter: adapter)
+  env_key_exists = ENV.fetch(env_var_name, nil)
+
+  unless db_key_exists || env_key_exists
+    # No API key found - prompt user
+    puts RubyCode::Views::Cli::ApiKeyMissing.build(adapter: adapter)
+    api_key = prompt.mask(I18n.t("rubycode.setup.api_key_prompt", adapter: adapter.to_s.upcase))
+
+    if api_key.nil? || api_key.empty?
+      puts "\n#{I18n.t("rubycode.setup.api_key_required")}\n"
+      exit 1
+    end
+
+    # Save to database
+    RubyCode::Models::ApiKey.save_key(adapter: adapter, api_key: api_key)
+    puts "\n✓ API key saved\n"
+  end
+end
+
+ChatContext = Struct.new(:prompt, :client, :adapter, :model, :full_path, :debug_mode)
+
+def run_chat_loop(context)
+  loop do
+    user_input = get_user_input(context.prompt)
+    break if user_input.nil?
+
+    next if handle_special_command(user_input, context)
+
+    process_user_message(context.client, user_input)
+  end
+end
+
+def get_user_input(prompt)
+  prompt.ask("You: ")
+rescue StandardError
+  nil
+end
+
+def handle_special_command(input, context)
+  case input.strip.downcase
+  when "exit", "quit"
+    puts RubyCode::Views::Cli::ExitMessage.build
+    exit 0
+  when "clear"
+    context.client.clear_memory
+    puts RubyCode::Views::Cli::MemoryClearedMessage.build
+    true
+  when "config"
+    show_config_and_reconfigure(context)
+    true
+  else
+    false
+  end
+end
+
+def show_config_and_reconfigure(context)
+  puts RubyCode::Views::Cli::ConfigurationTable.build(
+    adapter: context.adapter,
+    model: context.model,
+    directory: context.full_path,
+    debug_mode: context.debug_mode
+  )
+
+  return unless context.prompt.yes?(I18n.t("rubycode.setup.reconfigure"), default: false)
+
+  puts RubyCode::Views::Cli::RestartMessage.build
+  setup_wizard(context.prompt)
+end
+
+def process_user_message(client, user_input)
+  response = client.ask(prompt: user_input)
+  puts RubyCode::Views::Cli::ResponseBox.build(response: response)
+rescue Interrupt
+  puts RubyCode::Views::Cli::InterruptMessage.build
+rescue StandardError => e
+  puts RubyCode::Views::Cli::ErrorDisplay.build(error: e)
+end
+
+client = RubyCode::Client.new(tty_prompt: prompt)
+
+puts RubyCode::Views::Cli::ReadyMessage.build
+
+debug_mode = false # Debug mode not yet implemented
+context = ChatContext.new(prompt, client, adapter, model, full_path, debug_mode)
+run_chat_loop(context)

data/lib/rubycode/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RubyCode
-  VERSION = "0.1.4"
+  VERSION = "0.1.5"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rubycode
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.5
 platform: ruby
 authors:
 - Jonas Medeiros
@@ -224,7 +224,8 @@ description: Ruby-native AI coding agent with pluggable LLM adapters, persistent
   history, and user approval workflows for file modifications.
 email:
 - jonas.g.medeiros@gmail.com
-executables: []
+executables:
+- rubycode_client
 extensions: []
 extra_rdoc_files: []
 files:
@@ -246,6 +247,7 @@ files:
 - config/tools/websearch.json
 - config/tools/write.json
 - docs/images/demo.png
+- exe/rubycode_client
 - lib/rubycode.rb
 - lib/rubycode/adapters/base.rb
 - lib/rubycode/adapters/concerns/debugging.rb