ruby_coded 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f81632e5f552b3eb5e4e85d15ae4ecda0767c2f530606ccc083c9c1adcf9c92f
+  data.tar.gz: 33759f15b1568c1f0e2c88fbc32d9e97ca3772662aeaa0112acceb1819ab7a9a
+SHA512:
+  metadata.gz: d004abb1a5c5197cffc6b28fffb44172ed6b4cb22b62cf3438941d8c67b2869d7244df4d7c60cc63d1a28ce0dbd6dd20e5ab6fadff6b3e3f4bc89780d7c54d7a
+  data.tar.gz: ca3ff79da79a9fba4b2166deedb5eaa52626aaad0a3429dcb9ef75134fd831c852f4e1e3ff66d8d71cc234dc23e1a0c60b90f8dcab7166deaa5675e806052294

data/.github/workflows/ci.yml

@@ -0,0 +1,76 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    name: Test (Ruby ${{ matrix.ruby }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ["3.3", "3.4"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Remove Gemfile.lock for CI compatibility
+        run: rm -f Gemfile.lock
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - name: Run tests
+        run: bundle exec rake test
+
+  test-head:
+    name: Test (Ruby head)
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v4
+      - name: Remove Gemfile.lock for CI compatibility
+        run: rm -f Gemfile.lock
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: head
+          bundler-cache: true
+      - name: Run tests
+        run: bundle exec rake test
+
+  lint:
+    name: RuboCop
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Remove Gemfile.lock for CI compatibility
+        run: rm -f Gemfile.lock
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+      - name: Run RuboCop
+        run: bundle exec rake rubocop
+
+  build:
+    name: Build Gem
+    runs-on: ubuntu-latest
+    needs: [test, lint]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Remove Gemfile.lock for CI compatibility
+        run: rm -f Gemfile.lock
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+      - name: Build gem
+        run: gem build ruby_coded.gemspec
+      - name: Verify gem was built
+        run: ls ruby_coded-*.gem

data/.github/workflows/release.yml

@@ -0,0 +1,24 @@
+name: Release
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    name: Publish to RubyGems
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: main
+          fetch-depth: 0
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+      - uses: rubygems/release-gem@v1

data/.rubocop_todo.yml

@@ -0,0 +1,122 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config --auto-gen-only-exclude --exclude-limit 999`
+# on 2026-04-15 07:58:11 UTC using RuboCop version 1.86.1.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EmptyLineBetweenMethodDefs, EmptyLineBetweenClassDefs, EmptyLineBetweenModuleDefs, DefLikeMacros, AllowAdjacentOneLineDefs, NumberOfEmptyLines.
+Layout/EmptyLineBetweenDefs:
+  Exclude:
+    - 'test/test_agent_commands.rb'
+    - 'test/test_renderer_chat_panel.rb'
+
+# Offense count: 5
+# This cop supports safe autocorrection (--autocorrect).
+Layout/EmptyLines:
+  Exclude:
+    - 'test/test_agent_commands.rb'
+    - 'test/test_model_commands.rb'
+    - 'test/test_renderer_chat_panel.rb'
+    - 'test/test_renderer_model_selector.rb'
+    - 'test/test_state_model_selection.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: empty_lines, empty_lines_except_namespace, empty_lines_special, no_empty_lines, beginning_only, ending_only
+Layout/EmptyLinesAroundClassBody:
+  Exclude:
+    - 'lib/ruby_coded/chat/app.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: empty_lines, empty_lines_except_namespace, empty_lines_special, no_empty_lines
+Layout/EmptyLinesAroundModuleBody:
+  Exclude:
+    - 'lib/ruby_coded/chat/command_handler/token_commands.rb'
+    - 'lib/ruby_coded/chat/renderer/plan_clarifier.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
+# URISchemes: http, https
+Layout/LineLength:
+  Exclude:
+    - 'lib/ruby_coded/chat/llm_bridge/streaming_retries.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
+Metrics/AbcSize:
+  Exclude:
+    - 'lib/ruby_coded/chat/state.rb'
+
+# Offense count: 1
+# Configuration parameters: CountComments, Max, CountAsOne.
+Metrics/ClassLength:
+  Exclude:
+    - 'lib/ruby_coded/chat/state.rb'
+
+# Offense count: 2
+# Configuration parameters: CountComments, Max, CountAsOne, AllowedMethods, AllowedPatterns.
+Metrics/MethodLength:
+  Exclude:
+    - 'lib/ruby_coded/chat/state.rb'
+    - 'lib/ruby_coded/strategies/oauth_strategy.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, BlockForwardingName.
+# SupportedStyles: anonymous, explicit
+Naming/BlockForwarding:
+  Exclude:
+    - 'test/test_initializer.rb'
+
+# Offense count: 2
+# Configuration parameters: Mode, AllowedMethods, AllowedPatterns, AllowBangMethods, WaywardPredicates.
+# AllowedMethods: call
+# WaywardPredicates: infinite?, nonzero?
+Naming/PredicateMethod:
+  Exclude:
+    - 'lib/ruby_coded/strategies/api_key_strategy.rb'
+    - 'lib/ruby_coded/strategies/oauth_strategy.rb'
+
+# Offense count: 1
+# Configuration parameters: NamePrefix, ForbiddenPrefixes, AllowedMethods, MethodDefinitionMacros, UseSorbetSigs.
+# NamePrefix: is_, has_, have_, does_
+# ForbiddenPrefixes: is_, has_, have_, does_
+# AllowedMethods: is_a?
+# MethodDefinitionMacros: define_method, define_singleton_method
+Naming/PredicatePrefix:
+  Exclude:
+    - 'lib/ruby_coded/chat/state/plan_tracking.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowOnlyRestArgument, UseAnonymousForwarding, RedundantRestArgumentNames, RedundantKeywordRestArgumentNames, RedundantBlockArgumentNames.
+# RedundantRestArgumentNames: args, arguments
+# RedundantKeywordRestArgumentNames: kwargs, options, opts
+# RedundantBlockArgumentNames: blk, block, proc
+Style/ArgumentsForwarding:
+  Exclude:
+    - 'test/test_initializer.rb'
+
+# Offense count: 1
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: EnforcedStyle, AllowedMethods, AllowedPatterns.
+# SupportedStyles: predicate, comparison
+Style/NumericPredicate:
+  Exclude:
+    - 'lib/ruby_coded/chat/state.rb'
+
+# Offense count: 3
+# This cop supports safe autocorrection (--autocorrect).
+Style/SuperArguments:
+  Exclude:
+    - 'lib/ruby_coded/errors/auth_error.rb'
+    - 'test/test_renderer_chat_panel.rb'
+    - 'test/test_renderer_status_bar.rb'

data/CHANGELOG.md

@@ -0,0 +1,9 @@
+## [Unreleased]
+
+## [0.1.0] - 2026-04-15
+
+- Initial release
+
+## [0.1.1] - 2026-04-15
+
+- Fix CI workflow

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,10 @@
+# Code of Conduct
+
+"ruby_coded" follows [The Ruby Community Conduct Guideline](https://www.ruby-lang.org/en/conduct) in all "collaborative space", which is defined as community communications channels (such as mailing lists, submitted patches, commit comments, etc.):
+
+* Participants will be tolerant of opposing views.
+* Participants must ensure that their language and actions are free of personal attacks and disparaging personal remarks.
+* When interpreting the words and actions of others, participants should always assume good intentions.
+* Behaviour which can be reasonably considered harassment will not be tolerated.
+
+If you have any concerns about behaviour within this project, please contact us at ["cesar.rodriguez.lara54@gmail.com"](mailto:"cesar.rodriguez.lara54@gmail.com").

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Cesar Rodriguez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,140 @@
+# RubyCoded
+
+```
+         /\
+        /  \
+       /    \         ____        _              ____          _
+      /------\       |  _ \ _   _| |__  _   _   / ___|___   __| | ___   __| |
+     /  \  /  \      | |_) | | | | '_ \| | | | | |   / _ \ / _` |/ _ \ / _` |
+    /    \/    \     |  _ <| |_| | |_) | |_| | | |__| (_) | (_| |  __/ (_| |
+    \    /\    /     |_| \_\\__,_|_.__/ \__, |  \____\___/ \__,_|\___| \__,_|
+     \  /  \  /                         |___/
+      \/    \/
+       \    /
+        \  /
+         \/
+```
+
+An AI-powered terminal coding assistant built in Ruby. Chat with LLMs, let an agent edit your project files, or plan tasks — all from your terminal.
+
+## Features
+
+- **Chat mode** — Talk to an LLM directly in a full terminal UI (TUI) built with [ratatui](https://github.com/nicholasgasior/ratatui-ruby)
+- **Agent mode** — The model can read, write, edit, and delete files in your project, create directories, and run shell commands with user confirmation
+- **Plan mode** — Generate structured plans before implementing, with interactive clarification questions and auto-switch to agent mode when ready
+- **Multi-provider support** — Works with OpenAI and Anthropic out of the box (OAuth and API key authentication)
+- **Tool confirmation** — Write and dangerous operations require explicit approval; safe operations (read, list) run automatically
+- **Token & cost tracking** — Live status bar showing token usage and estimated session cost
+- **Plugin system** — Extend the chat with custom state, input handlers, renderer overlays, and commands
+- **Slash commands** — `/agent`, `/plan`, `/model`, `/history`, `/tokens`, `/help`, and more
+
+## Requirements
+
+- Ruby >= 3.3.0
+- An OpenAI or Anthropic account (API key or OAuth)
+
+## Installation
+
+```bash
+gem install ruby_coded
+```
+
+## Usage
+
+Navigate to any project directory and run:
+
+```bash
+ruby_coded
+```
+
+On first launch you'll be asked to authenticate with a provider. After that, you're dropped into chat mode.
+
+### Modes
+
+| Command | Description |
+|---|---|
+| `/agent on` | Enable agent mode (file tools + shell access) |
+| `/agent off` | Disable agent mode |
+| `/plan on` | Enable plan mode (read-only tools, structured planning) |
+| `/plan off` | Disable plan mode |
+| `/plan save` | Save the current plan to a file |
+| `/model` | Switch to a different model |
+| `/tokens` | Show detailed token usage breakdown |
+| `/history` | Show conversation history |
+| `/clear` | Clear the conversation |
+| `/help` | Show all available commands |
+
+### Agent mode
+
+When agent mode is active, the model has access to these tools:
+
+| Tool | Risk level | Description |
+|---|---|---|
+| `read_file` | Safe | Read file contents |
+| `list_directory` | Safe | List directory contents |
+| `write_file` | Confirm | Write a new file |
+| `edit_file` | Confirm | Search and replace in a file |
+| `create_directory` | Confirm | Create a new directory |
+| `delete_path` | Dangerous | Delete a file or directory |
+| `run_command` | Dangerous | Execute a shell command |
+
+Safe tools run without asking. Confirm and dangerous tools show the operation details and wait for your approval (`y` to approve, `n` to reject, `a` to approve all remaining).
+
+### Plan mode
+
+Plan mode restricts the model to read-only tools and a planning-oriented system prompt. The model will analyze your project and propose a structured plan. If the model needs clarification, it presents interactive options you can select or answer with custom text.
+
+## Keyboard shortcuts
+
+| Key | Action |
+|---|---|
+| `Enter` | Send message |
+| `Esc` | Cancel streaming / clear input |
+| `Ctrl+C` | Quit |
+| `Up/Down` | Scroll chat history |
+| `Left/Right` | Move cursor in input |
+| `Home/End` | Jump to start/end of input |
+| `Tab` | Autocomplete commands |
+
+## Development
+
+```bash
+git clone https://github.com/MrCesar107/ruby_code.git
+cd ruby_code
+bundle install
+bundle exec rake test
+```
+
+To run the application locally:
+
+```bash
+bundle exec exe/ruby_coded
+```
+
+## What's next
+
+- Find a way to update the autocomplete plugin when a new command is added []
+- Display context window size (depending on the model) []
+- UI element to indicate the AI is performing a task []
+- Add the possibility to create custom commands []
+- Skills implementation []
+- Implement Google Auth for Gemini []
+- Session recovery system by ID []
+
+## Contributing
+
+Contributions are welcome! To get started:
+
+1. Fork the repository
+2. Create a new branch for your feature or fix (`git checkout -b my-feature`)
+3. Make your changes and add tests if applicable
+4. Make sure all tests pass (`bundle exec rake test`)
+5. Commit your changes (`git commit -m "Add my feature"`)
+6. Push to your fork (`git push origin my-feature`)
+7. Open a Pull Request against the `main` branch of this repository
+
+Your PR will be reviewed and merged if everything looks good. If you're unsure about a change, feel free to open an issue first to discuss it.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[test rubocop]

data/exe/ruby_coded

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/ruby_coded"
+
+RubyCoded.start

data/lib/ruby_coded/auth/auth_manager.rb

@@ -0,0 +1,145 @@
+# frozen_string_literal: true
+
+require "yaml"
+require "time"
+require "ruby_llm"
+require "tty-prompt"
+
+require_relative "providers/openai"
+require_relative "providers/anthropic"
+require_relative "../strategies/oauth_strategy"
+require_relative "../strategies/api_key_strategy"
+require_relative "credentials_store"
+
+module RubyCoded
+  module Auth
+    # This class is used to manage the authentication process for the different
+    # AI providers
+    class AuthManager
+      PROVIDERS = {
+        openai: Providers::OpenAI,
+        anthropic: Providers::Anthropic
+      }.freeze
+
+      def initialize(config_path: UserConfig::CONFIG_PATH)
+        @config_path = config_path
+      end
+
+      def login(provider_name)
+        provider = PROVIDERS.fetch(provider_name)
+        strategy = strategy_for(provider)
+        credentials = strategy.authenticate
+        credential_store.store(provider_name, credentials)
+        configure_ruby_llm!
+        print_api_credits_notice(provider)
+        credentials
+      end
+
+      def logout(provider_name)
+        credential_store.remove(provider_name)
+        configure_ruby_llm!
+      end
+
+      def configured_providers
+        PROVIDERS.keys
+      end
+
+      def authenticated_provider_names
+        PROVIDERS.keys.select { |name| credential_store.retrieve(name) }
+      end
+
+      def check_authentication
+        return if configured_providers.any? { |name| credential_store.retrieve(name) }
+
+        provider_name = choose_provider
+        login(provider_name)
+      end
+
+      def login_prompt
+        provider_name = choose_provider
+        login(provider_name)
+      end
+
+      def configure_ruby_llm!
+        RubyLLM.configure do |config|
+          config.max_retries = 1
+
+          PROVIDERS.each do |name, provider|
+            credentials = credential_store.retrieve(name)
+            next unless credentials
+
+            credentials = refresh_if_expired(name, provider, credentials)
+            key = extract_api_key(credentials)
+            config.send("#{provider.ruby_llm_key}=", key)
+          end
+        end
+      end
+
+      private
+
+      def prompt
+        @prompt ||= TTY::Prompt.new
+      end
+
+      def choose_provider
+        prompt.select("Please select the AI provider you want to log in:",
+                      configured_providers,
+                      per_page: 10)
+      end
+
+      def strategy_for(provider)
+        method = choose_auth_method(provider)
+        case method
+        when :oauth   then Strategies::OAuthStrategy.new(provider)
+        when :api_key then Strategies::APIKeyStrategy.new(provider)
+        else
+          raise "Invalid authentication method: #{method}"
+        end
+      end
+
+      def credential_store
+        @credential_store ||= CredentialsStore.new(config_path: @config_path)
+      end
+
+      def extract_api_key(credentials)
+        case credentials["auth_method"]
+        when "oauth"   then credentials["access_token"]
+        when "api_key" then credentials["key"]
+        end
+      end
+
+      def refresh_if_expired(provider_name, provider, credentials)
+        return credentials unless credentials["auth_method"] == "oauth"
+        return credentials unless token_expired?(credentials)
+
+        strategy = Strategies::OAuthStrategy.new(provider)
+        refreshed = strategy.refresh(credentials)
+        credential_store.store(provider_name, refreshed)
+        refreshed
+      rescue StandardError
+        credentials
+      end
+
+      def token_expired?(credentials)
+        expires_at = credentials["expires_at"]
+        return false unless expires_at
+
+        Time.parse(expires_at) <= Time.now + 60
+      end
+
+      def print_api_credits_notice(provider)
+        console = provider.respond_to?(:console_url) ? provider.console_url : nil
+        billing_hint = console ? " Check your balance at #{console}." : ""
+        puts "\nNote: API usage consumes credits from your #{provider.display_name} account.#{billing_hint}\n\n"
+      end
+
+      def choose_auth_method(provider)
+        methods = provider.auth_methods
+        return methods.first[:key] if methods.size == 1
+
+        choices = methods.map { |m| { name: m[:label], value: m[:key] } }
+        prompt.select("How would you like to authenticate with #{provider.display_name}?", choices)
+      end
+    end
+  end
+end

data/lib/ruby_coded/auth/callback_servlet.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module RubyCoded
+  module Auth
+    # This class creates a callback servlet for the OAuth authentication
+    class CallbackServlet < WEBrick::HTTPServlet::AbstractServlet
+      SUCCESS_HTML = <<~HTML
+        <html>
+          <body>
+            <h2>You are now logged</h2>
+            <p>You can close this window now.</p>
+            <script>window.close();</script>
+          </body>
+        </html>
+      HTML
+
+      def initialize(server, result_queue)
+        super(server)
+        @result_queue = result_queue
+      end
+
+      def do_GET(request, response) # rubocop:disable Naming/MethodName
+        process_callback(request)
+        response.status = 200
+        response.content_type = "text/html"
+        response.body = SUCCESS_HTML
+      end
+
+      private
+
+      def process_callback(request)
+        error = request.query["error"]
+        if error
+          @result_queue.push({ error: error })
+        else
+          @result_queue.push({ code: request.query["code"], state: request.query["state"] })
+        end
+      end
+    end
+  end
+end

data/lib/ruby_coded/auth/credentials_store.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require "yaml"
+
+require_relative "../config/user_config"
+
+module RubyCoded
+  module Auth
+    # This class is used to manage the credentials in the config file
+    class CredentialsStore
+      def initialize(config_path: UserConfig::CONFIG_PATH)
+        @config = UserConfig.new(config_path: config_path)
+      end
+
+      def store(provider_name, credentials)
+        cfg = @config.full_config
+        cfg["providers"] ||= {}
+        cfg["providers"][provider_name.to_s] = credentials
+        @config.save
+      end
+
+      def retrieve(provider_name)
+        @config.full_config.dig("providers", provider_name.to_s)
+      end
+
+      def remove(provider_name)
+        providers = @config.full_config["providers"]
+        return unless providers
+
+        providers.delete(provider_name.to_s)
+        @config.save
+      end
+    end
+  end
+end