girb 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3444545df799e66732b89937b28d45758677db42c567c855b18bbea51bb09a63
-  data.tar.gz: bc5b78829ab8739e2add32cd2aedc139705d749db0efe176b25e1da1dce25822
+  metadata.gz: '048b4dc3910c2afaa9bb1bd2a1f2f33f51b631b74405368daabec4cbf1ef1e2a'
+  data.tar.gz: d5b46f5c7c0f809053c8b38fd15f9af6709338c62cb2374f0a64b25f283b1807
 SHA512:
-  metadata.gz: 2a2b5fa25eab058edcc21e8ef06b95b1df8ca256ff5608fe89fe72eac7056429894e1b665087ca46e5dfc32586097e4e78652dfa59a3d92a008a7c981ab042c4
-  data.tar.gz: 770e74219dadc08011320fd3b48c8ad231055ccb0ed5827bce2221042cc8208b0eaca094015a4786bbfd6306a843df9d255106ca3f17659b5027df6ce6e85acf
+  metadata.gz: 3e064f6e9a5dcd1ea6af090ccfc9aff2acc476fcafff772aed594ff15ecb95cfe6513e8e7facccbea490d82d691b9e495d4134fe418f8fb2d0b7bfab0e40fe25
+  data.tar.gz: 3287871b7937ea1234fdb18c6e551b96da944b12a57305b3e6c5fe5e63d2d602afa04aedc88192331176b70062ad4efc1bcfeb5c7bf3285ce603a3e090a1f005

data/CHANGELOG.md

@@ -1,5 +1,57 @@
 # Changelog
 
+## [0.2.0] - 2026-02-05
+
+### Added
+
+- **Debug gem (rdbg) integration**: AI assistant for step-through debugging
+  - `ai <question>` command in debugger
+  - Ctrl+Space to send input to AI
+  - Auto-routing of non-ASCII (Japanese) input to AI
+  - `run_debug_command` tool for AI to execute debugger commands (step, next, continue, break, etc.)
+- **Auto-continue for autonomous AI investigation**
+  - `continue_analysis` tool for IRB mode context refresh
+  - AI can loop through investigate-execute-analyze cycles
+  - Configurable iteration limits (MAX_ITERATIONS = 20)
+- **Ctrl+C interrupt support** for both IRB and debug modes
+  - Graceful interruption of long-running AI operations
+  - AI summarizes progress when interrupted
+- **Debug session history tracking**
+  - Track debugger commands and AI conversations
+  - `get_session_history` tool for debug mode
+- **Efficient variable tracking** with silent breakpoints
+  - `break file:line if: ($var << x; false)` pattern for recording without stopping
+
+### Changed
+
+- Separate tool sets for IRB and debug modes
+  - SHARED_TOOLS: Common tools for both modes
+  - IRB_TOOLS: SessionHistoryTool, ContinueAnalysis
+  - DEBUG_TOOLS: DebugSessionHistoryTool, RunDebugCommand
+- Improved prompts for debug mode
+  - Guidance on variable persistence across frames
+  - Instructions for efficient breakpoint usage
+  - Context-aware investigation (don't use tools for greetings)
+
+### Fixed
+
+- Tool calls now include IDs for proper conversation history
+- Auto-continue loop properly exits when debug commands are queued
+
+## [0.1.2] - 2026-02-03
+
+### Added
+
+- `.girbrc` configuration file support with directory traversal
+- Railtie for automatic Rails console integration
+- GirbrcLoader utility for finding and loading `.girbrc` files
+- `get_current_directory` tool for non-Rails environments
+
+### Changed
+
+- Recommend `.girbrc` configuration instead of `~/.irbrc`
+- `girb` command now loads `.girbrc` before falling back to environment variables
+
 ## [0.1.1] - 2026-02-03
 
 ### Changed

data/README.md

@@ -10,17 +10,22 @@ An AI assistant embedded in your IRB session. It understands your runtime contex
 - **Exception Capture**: Automatically captures recent exceptions - just ask "why did this fail?" after an error
 - **Session History Understanding**: Tracks IRB input history and understands conversation flow
 - **Tool Execution**: AI autonomously executes code, inspects objects, and retrieves source code
+- **Autonomous Investigation**: AI can loop through investigate-execute-analyze cycles using `continue_analysis`
+- **Debug Gem Integration**: Use with Ruby's debug gem for step-through debugging with AI assistance
 - **Multi-language Support**: Detects user's language and responds in the same language
 - **Customizable**: Add custom prompts for project-specific instructions
 - **Provider Agnostic**: Use any LLM provider or implement your own
 
 ## Installation
 
+### For Rails Projects
+
 Add to your Gemfile:
 
 ```ruby
-gem 'girb'
-gem 'girb-ruby_llm'  # or girb-gemini
+group :development do
+  gem 'girb-ruby_llm'  # or girb-gemini
+end
 ```
 
 Then run:
@@ -29,84 +34,76 @@ Then run:
 bundle install
 ```
 
-Or install directly:
+Create a `.girbrc` file in your project root:
 
-```bash
-gem install girb girb-ruby_llm
-```
-
-Set the provider via environment variable:
+```ruby
+# .girbrc
+require 'girb-ruby_llm'
 
-```bash
-export GIRB_PROVIDER=girb-ruby_llm
+Girb.configure do |c|
+  c.provider = Girb::Providers::RubyLlm.new(model: 'gemini-2.5-flash')
+end
 ```
 
-## Providers
+Now `rails console` will automatically load girb!
 
-Currently available providers:
+### For Non-Rails Projects
 
-- [girb-ruby_llm](https://github.com/rira100000000/girb-ruby_llm) - Multiple providers via RubyLLM (OpenAI, Anthropic, Gemini, Ollama, etc.)
-- [girb-gemini](https://github.com/rira100000000/girb-gemini) - Google Gemini
-
-You can also [create your own provider](#custom-providers).
-
-## Setup
-
-### Using girb-ruby_llm (Recommended)
-
-girb-ruby_llm supports multiple LLM providers through RubyLLM.
+Install globally:
 
 ```bash
 gem install girb girb-ruby_llm
 ```
 
-Add to your `~/.irbrc`:
+Create a `.girbrc` file in your project directory:
 
 ```ruby
+# .girbrc
 require 'girb-ruby_llm'
 
-RubyLLM.configure do |config|
-  config.gemini_api_key = 'your-api-key'
-end
-
 Girb.configure do |c|
   c.provider = Girb::Providers::RubyLlm.new(model: 'gemini-2.5-flash')
 end
 ```
 
-See [girb-ruby_llm README](https://github.com/rira100000000/girb-ruby_llm) for more options (OpenAI, Anthropic, Ollama, etc.).
+Then use `girb` command instead of `irb`.
 
-### Using girb-gemini
+## How .girbrc Works
 
-```bash
-gem install girb girb-gemini
-```
+girb searches for `.girbrc` in the following order:
 
-Add to your `~/.irbrc`:
+1. Current directory, then parent directories (up to root)
+2. `~/.girbrc` as fallback
 
-```ruby
-require 'girb-gemini'
+This allows you to:
 
-Girb.configure do |c|
-  c.provider = Girb::Providers::Gemini.new(
-    api_key: 'your-api-key',
-    model: 'gemini-2.5-flash'
-  )
-end
-```
+- **Project-specific settings**: Place `.girbrc` in your project root
+- **Shared settings**: Place `.girbrc` in a parent directory (e.g., `~/work/.girbrc` for all work projects)
+- **Global default**: Place `.girbrc` in your home directory
+
+## Providers
+
+Currently available providers:
+
+- [girb-ruby_llm](https://github.com/rira100000000/girb-ruby_llm) - Multiple providers via RubyLLM (OpenAI, Anthropic, Gemini, Ollama, etc.)
+- [girb-gemini](https://github.com/rira100000000/girb-gemini) - Google Gemini
+
+You can also [create your own provider](#custom-providers).
 
 ## Usage
 
-### Quick Start
+### For Rails Projects
 
 ```bash
-girb
+rails console
 ```
 
-Or add to your `~/.irbrc` for automatic loading with regular `irb`:
+girb is automatically loaded via Railtie.
 
-```ruby
-require 'girb-ruby_llm'  # or 'girb-gemini'
+### For Non-Rails Projects
+
+```bash
+girb
 ```
 
 ### Debug with binding.girb
@@ -121,6 +118,34 @@ def problematic_method
 end
 ```
 
+### Debug with debug gem (rdbg)
+
+For step-through debugging with AI assistance, add `require "girb"` to your script:
+
+```ruby
+require "girb"
+
+def problematic_method
+  result = some_calculation
+  result
+end
+
+problematic_method
+```
+
+Then run with rdbg:
+
+```bash
+rdbg your_script.rb
+```
+
+In the debugger, use:
+- `ai <question>` - Ask AI a question
+- `Ctrl+Space` - Send current input to AI
+- Natural language (non-ASCII) input is automatically routed to AI
+
+The AI can execute debugger commands like `step`, `next`, `continue`, and set breakpoints for you.
+
 ### How to Ask AI
 
 #### Method 1: Ctrl+Space
@@ -139,7 +164,7 @@ irb(main):001> qq "How do I use this method?"
 
 ## Configuration Options
 
-Add to your `~/.irbrc`:
+Add to your `.girbrc`:
 
 ```ruby
 require 'girb-ruby_llm'
@@ -165,10 +190,12 @@ girb --help     # Show help
 
 ### Environment Variables
 
+For `girb` command, you can also configure via environment variables (used when no `.girbrc` is found):
+
 | Variable | Description |
 |----------|-------------|
-| `GIRB_PROVIDER` | **Required.** Provider gem to load (e.g., `girb-ruby_llm`, `girb-gemini`) |
-| `GIRB_MODEL` | Model to use (e.g., `gemini-2.5-flash`, `gpt-4o`). Required for girb-ruby_llm. |
+| `GIRB_PROVIDER` | Provider gem to load (e.g., `girb-ruby_llm`, `girb-gemini`) |
+| `GIRB_MODEL` | Model to use (e.g., `gemini-2.5-flash`, `gpt-4o`) |
 | `GIRB_DEBUG` | Set to `1` to enable debug output |
 
 ## Available Tools
@@ -182,6 +209,7 @@ girb --help     # Show help
 | `find_file` | Search for files in the project |
 | `read_file` | Read file contents |
 | `session_history` | Get IRB session history |
+| `continue_analysis` | Request context refresh for autonomous investigation |
 
 ### Additional Tools in Rails Environment
 
@@ -190,6 +218,12 @@ girb --help     # Show help
 | `query_model` | Execute queries on ActiveRecord models |
 | `model_info` | Get model schema information |
 
+### Additional Tools in Debug Mode (rdbg)
+
+| Tool | Description |
+|------|-------------|
+| `run_debug_command` | Execute debugger commands (step, next, continue, break, etc.) |
+
 ## Custom Providers
 
 Implement your own LLM provider:
@@ -220,12 +254,6 @@ Girb.configure do |c|
 end
 ```
 
-Then run with:
-
-```bash
-GIRB_PROVIDER=my_provider girb
-```
-
 ## Examples
 
 ### Debugging Assistance

data/README_ja.md

@@ -8,17 +8,22 @@ IRBセッションに組み込まれたAIアシスタント。実行中のコン
 - **例外キャプチャ**: 直前の例外を自動キャプチャ - エラー後に「なぜ失敗した？」と聞くだけでOK
 - **セッション履歴の理解**: IRBでの入力履歴を追跡し、会話の流れを理解
 - **ツール実行**: コードの実行、オブジェクトの検査、ソースコードの取得などをAIが自律的に実行
+- **自律的な調査**: `continue_analysis`を使って、調査→実行→分析のサイクルをAIが自律的にループ可能
+- **debug gem統合**: Rubyのdebug gemと連携し、AIアシスタント付きのステップ実行デバッグが可能
 - **多言語対応**: ユーザーの言語を検出し、同じ言語で応答
 - **カスタマイズ可能**: 独自のプロンプトを追加して、プロジェクト固有の指示を設定可能
 - **プロバイダー非依存**: 任意のLLMプロバイダーを使用、または独自実装が可能
 
 ## インストール
 
+### Railsプロジェクトの場合
+
 Gemfileに追加:
 
 ```ruby
-gem 'girb'
-gem 'girb-ruby_llm'  # または girb-gemini
+group :development do
+  gem 'girb-ruby_llm'  # または girb-gemini
+end
 ```
 
 そして実行:
@@ -27,84 +32,76 @@ gem 'girb-ruby_llm'  # または girb-gemini
 bundle install
 ```
 
-または直接インストール:
+プロジェクトルートに `.girbrc` ファイルを作成:
 
-```bash
-gem install girb girb-ruby_llm
-```
-
-環境変数でプロバイダーを設定:
+```ruby
+# .girbrc
+require 'girb-ruby_llm'
 
-```bash
-export GIRB_PROVIDER=girb-ruby_llm
+Girb.configure do |c|
+  c.provider = Girb::Providers::RubyLlm.new(model: 'gemini-2.5-flash')
+end
 ```
 
-## プロバイダー
+これで `rails console` が自動的にgirbを読み込みます！
 
-現在利用可能なプロバイダー:
+### 非Railsプロジェクトの場合
 
-- [girb-ruby_llm](https://github.com/rira100000000/girb-ruby_llm) - RubyLLM経由で複数プロバイダー対応（OpenAI、Anthropic、Gemini、Ollama等）
-- [girb-gemini](https://github.com/rira100000000/girb-gemini) - Google Gemini
-
-[独自プロバイダーの作成](#カスタムプロバイダー)も可能です。
-
-## セットアップ
-
-### girb-ruby_llmを使用する場合（推奨）
-
-girb-ruby_llmはRubyLLMを通じて複数のLLMプロバイダーをサポートしています。
+グローバルにインストール:
 
 ```bash
 gem install girb girb-ruby_llm
 ```
 
-`~/.irbrc` に追加:
+プロジェクトディレクトリに `.girbrc` ファイルを作成:
 
 ```ruby
+# .girbrc
 require 'girb-ruby_llm'
 
-RubyLLM.configure do |config|
-  config.gemini_api_key = 'your-api-key'
-end
-
 Girb.configure do |c|
   c.provider = Girb::Providers::RubyLlm.new(model: 'gemini-2.5-flash')
 end
 ```
 
-詳細な設定（OpenAI、Anthropic、Ollama等）については [girb-ruby_llm README](https://github.com/rira100000000/girb-ruby_llm) を参照してください。
+`irb` の代わりに `girb` コマンドを使用します。
 
-### girb-geminiを使用する場合
+## .girbrc の仕組み
 
-```bash
-gem install girb girb-gemini
-```
+girbは以下の順序で `.girbrc` を探します:
 
-`~/.irbrc` に追加:
+1. カレントディレクトリから親ディレクトリを遡って探索（ルートまで）
+2. `~/.girbrc` にフォールバック
 
-```ruby
-require 'girb-gemini'
+これにより:
 
-Girb.configure do |c|
-  c.provider = Girb::Providers::Gemini.new(
-    api_key: 'your-api-key',
-    model: 'gemini-2.5-flash'
-  )
-end
-```
+- **プロジェクト固有の設定**: プロジェクトルートに `.girbrc` を配置
+- **共有設定**: 親ディレクトリに `.girbrc` を配置（例: `~/work/.girbrc` で仕事用プロジェクト全体に適用）
+- **グローバルデフォルト**: ホームディレクトリに `.girbrc` を配置
+
+## プロバイダー
+
+現在利用可能なプロバイダー:
+
+- [girb-ruby_llm](https://github.com/rira100000000/girb-ruby_llm) - RubyLLM経由で複数プロバイダー対応（OpenAI、Anthropic、Gemini、Ollama等）
+- [girb-gemini](https://github.com/rira100000000/girb-gemini) - Google Gemini
+
+[独自プロバイダーの作成](#カスタムプロバイダー)も可能です。
 
 ## 使い方
 
-### 起動方法
+### Railsプロジェクトの場合
 
 ```bash
-girb
+rails console
 ```
 
-または `~/.irbrc` に以下を追加すると、通常の `irb` コマンドでも使えます:
+Railtieにより自動的にgirbが読み込まれます。
 
-```ruby
-require 'girb-ruby_llm'  # または 'girb-gemini'
+### 非Railsプロジェクトの場合
+
+```bash
+girb
 ```
 
 ### binding.girbでデバッグ
@@ -119,6 +116,34 @@ def problematic_method
 end
 ```
 
+### debug gem (rdbg) でデバッグ
+
+AIアシスタント付きのステップ実行デバッグを行うには、スクリプトに `require "girb"` を追加:
+
+```ruby
+require "girb"
+
+def problematic_method
+  result = some_calculation
+  result
+end
+
+problematic_method
+```
+
+rdbgで起動:
+
+```bash
+rdbg your_script.rb
+```
+
+デバッガ内では以下の方法でAIに質問できます:
+- `ai <質問>` - AIに質問
+- `Ctrl+Space` - 入力内容をAIに送信
+- 日本語（非ASCII文字）の入力は自動的にAIにルーティング
+
+AIは `step`、`next`、`continue` などのデバッガコマンドを実行したり、ブレークポイントを設定することもできます。
+
 ### AIへの質問方法
 
 #### 方法1: Ctrl+Space
@@ -137,7 +162,7 @@ irb(main):001> qq "このメソッドの使い方を教えて"
 
 ## 設定オプション
 
-`~/.irbrc` に追加:
+`.girbrc` に追加:
 
 ```ruby
 require 'girb-ruby_llm'
@@ -163,10 +188,12 @@ girb --help     # ヘルプを表示
 
 ### 環境変数
 
+`girb` コマンドでは、`.girbrc` が見つからない場合に環境変数で設定することもできます:
+
 | 変数 | 説明 |
 |------|------|
-| `GIRB_PROVIDER` | **必須。** 読み込むプロバイダーgem（例: `girb-ruby_llm`、`girb-gemini`） |
-| `GIRB_MODEL` | 使用するモデル（例: `gemini-2.5-flash`、`gpt-4o`）。girb-ruby_llmでは必須。 |
+| `GIRB_PROVIDER` | 読み込むプロバイダーgem（例: `girb-ruby_llm`、`girb-gemini`） |
+| `GIRB_MODEL` | 使用するモデル（例: `gemini-2.5-flash`、`gpt-4o`） |
 | `GIRB_DEBUG` | `1`に設定するとデバッグ出力を有効化 |
 
 ## AIが使用できるツール
@@ -180,6 +207,7 @@ girb --help     # ヘルプを表示
 | `find_file` | プロジェクト内のファイルを検索 |
 | `read_file` | ファイルの内容を読み取り |
 | `session_history` | IRBセッションの履歴を取得 |
+| `continue_analysis` | 自律調査のためのコンテキスト更新をリクエスト |
 
 ### Rails環境での追加ツール
 
@@ -188,6 +216,12 @@ girb --help     # ヘルプを表示
 | `query_model` | ActiveRecordモデルへのクエリ実行 |
 | `model_info` | モデルのスキーマ情報を取得 |
 
+### デバッグモード (rdbg) での追加ツール
+
+| ツール | 説明 |
+|--------|------|
+| `run_debug_command` | デバッガコマンドを実行（step、next、continue、breakなど） |
+
 ## カスタムプロバイダー
 
 独自のLLMプロバイダーを実装:
@@ -218,12 +252,6 @@ Girb.configure do |c|
 end
 ```
 
-実行:
-
-```bash
-GIRB_PROVIDER=my_provider girb
-```
-
 ## 使用例
 
 ### デバッグ支援

data/exe/girb

@@ -21,18 +21,25 @@ ENV["GIRB_DEBUG"] = "1" if options[:debug]
 
 require "irb"
 
-# Load girb and provider
+# Load girb
 require "girb"
 
-if ENV["GIRB_PROVIDER"]
-  begin
-    require ENV["GIRB_PROVIDER"]
-  rescue LoadError
-    warn "[girb] Failed to load provider: #{ENV["GIRB_PROVIDER"]}"
+# Load .girbrc (searches from current directory up to root, then ~/.girbrc)
+girbrc_loaded = Girb::GirbrcLoader.load_girbrc
+
+# If no .girbrc found, try environment variable based configuration
+unless girbrc_loaded
+  if ENV["GIRB_PROVIDER"]
+    begin
+      require ENV["GIRB_PROVIDER"]
+    rescue LoadError
+      warn "[girb] Failed to load provider: #{ENV["GIRB_PROVIDER"]}"
+    end
+  else
+    warn "[girb] No .girbrc found and GIRB_PROVIDER not set."
+    warn "[girb]   Create a .girbrc file or set GIRB_PROVIDER environment variable."
+    warn "[girb]   Example: GIRB_PROVIDER=girb-ruby_llm girb"
   end
-else
-  warn "[girb] No provider specified. Set GIRB_PROVIDER environment variable."
-  warn "[girb]   Example: GIRB_PROVIDER=girb-ruby_llm girb"
 end
 
 IRB.start