@@ -59,6 +59,14 @@ jobs:
         distribution: 'temurin'
         java-version: '21'
 
+    - name: Setup Ruby
+      uses: ruby/setup-ruby@89f90524b88a01fe6e0b732220432cc6142926af  # v1.313.0
+      with:
+        ruby-version: '3.3'
+
+    - name: Verify rdbg (bundled debug gem)
+      run: rdbg --version
+
     - name: Install Node dependencies
       run: pnpm install --frozen-lockfile
       env:
 
@@ -276,6 +276,7 @@ jobs:
         node -e 'console.log("SHARED_VERSION="+require("./packages/shared/package.json").version)' >> $GITHUB_ENV
         node -e 'console.log("ADAPTER_MOCK_VERSION="+require("./packages/adapter-mock/package.json").version)' >> $GITHUB_ENV
         node -e 'console.log("ADAPTER_PYTHON_VERSION="+require("./packages/adapter-python/package.json").version)' >> $GITHUB_ENV
+        node -e 'console.log("ADAPTER_RUBY_VERSION="+require("./packages/adapter-ruby/package.json").version)' >> $GITHUB_ENV
         node -e 'console.log("CLI_VERSION="+require("./packages/mcp-debugger/package.json").version)' >> $GITHUB_ENV
     - name: Set npm dist-tag
       run: |
@@ -295,6 +296,7 @@ jobs:
         npm pack --dry-run -w @debugmcp/shared
         npm pack --dry-run -w @debugmcp/adapter-mock
         npm pack --dry-run -w @debugmcp/adapter-python
+        npm pack --dry-run -w @debugmcp/adapter-ruby
         npm pack --dry-run -w @debugmcp/mcp-debugger
     
     - name: Publish to npm (workspaces)
@@ -322,6 +324,12 @@ jobs:
           npm publish -w @debugmcp/adapter-python --access public --provenance
         fi
 
+        if npm view @debugmcp/adapter-ruby@${ADAPTER_RUBY_VERSION} version >/dev/null 2>&1; then
+          echo "@debugmcp/adapter-ruby@${ADAPTER_RUBY_VERSION} already exists, skipping"
+        else
+          npm publish -w @debugmcp/adapter-ruby --access public --provenance
+        fi
+
         if npm view @debugmcp/mcp-debugger@${CLI_VERSION} version >/dev/null 2>&1; then
           echo "@debugmcp/mcp-debugger@${CLI_VERSION} already exists, skipping"
         else
@@ -399,6 +407,7 @@ jobs:
         **Optional adapters:**
         ```bash
         npm install -g @debugmcp/adapter-python
+        npm install -g @debugmcp/adapter-ruby
         npm install -g @debugmcp/adapter-mock
         ```
         
 
@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+- **Ruby debugging support** – launch and attach via `rdbg` (debug gem) DAP, including remote attach to containers and Kubernetes pods through port forwarding; conditional breakpoints, locals, repl-context expression evaluation, detach/re-attach (adapted from PR #88, contributed by [@Poyraxx](https://github.com/Poyraxx))
+- **Direct-connect attach** – adapter policies can now return a `connect`-mode spawn config to attach straight to an already-listening DAP server without spawning an adapter process; policy selection is driven by the session language via a single shared `getPolicyForLanguage()` mapping instead of adapter-command sniffing
+- **Ruby documentation** – `docs/ruby/README.md` user guide with verified launch/attach flows and Docker/Kubernetes remote-attach walkthroughs (`examples/ruby/remote-attach/`)
+
+### Fixed
+- Attach sessions no longer apply host-side file existence checks to breakpoint paths — attach targets may run on a remote filesystem (container, pod, other machine)
+- `test:unit` now actually runs the per-adapter unit suites on Windows (the `tests/adapters/*/unit` glob never expanded under cmd.exe)
+- CLI bundle prepare-pack workspace list updated for new adapter packages
+
 ## [0.21.0] - 2026-05-30
 
 ### Changed
 
@@ -15,6 +15,7 @@ mcp-debugger/
 ├── packages/
 │   ├── shared/             # Shared interfaces, types, and utilities
 │   ├── adapter-python/     # Python debug adapter using debugpy
+│   ├── adapter-ruby/       # Ruby debug adapter using rdbg (debug gem)
 │   ├── adapter-javascript/ # JavaScript/Node.js adapter using js-debug
 │   ├── adapter-rust/       # Rust debug adapter using CodeLLDB
 │   ├── adapter-go/         # Go debug adapter using Delve
@@ -34,6 +35,7 @@ mcp-debugger/
 
 - **@debugmcp/shared**: Core interfaces and types used across all packages
 - **@debugmcp/adapter-python**: Python debugging support via debugpy
+- **@debugmcp/adapter-ruby**: Ruby debugging support via rdbg (debug gem)
 - **@debugmcp/adapter-javascript**: JavaScript/Node.js debugging support via js-debug
 - **@debugmcp/adapter-rust**: Rust debugging support via CodeLLDB
 - **@debugmcp/adapter-go**: Go debugging support via Delve
@@ -57,7 +59,7 @@ npm run build
 
 # Build specific packages
 npm run build:shared
-npm run build:adapters       # Build mock + python adapters
+npm run build:adapters       # Build mock + python + ruby adapters
 npm run build:adapters:all   # Build all adapters including JavaScript
 npm run build:packages       # Build all packages in correct order via build-packages.cjs
 
@@ -246,9 +248,10 @@ A dual-state overlay (`SessionLifecycleState` + `ExecutionState`) is derived fro
 
 ### Adapter System
 - `src/adapters/adapter-registry.ts` - Adapter lifecycle management
-- `src/adapters/adapter-loader.ts` - Dynamic adapter loading (7 known adapters)
+- `src/adapters/adapter-loader.ts` - Dynamic adapter loading (8 known adapters)
 - `packages/shared/` - Shared interfaces and types
 - `packages/adapter-python/` - Python debug adapter (debugpy)
+- `packages/adapter-ruby/` - Ruby debug adapter (rdbg)
 - `packages/adapter-javascript/` - JavaScript/Node.js debug adapter (js-debug)
 - `packages/adapter-rust/` - Rust debug adapter (CodeLLDB)
 - `packages/adapter-go/` - Go debug adapter (Delve)
@@ -326,6 +329,13 @@ packages/adapter-{language}/
 - debugpy must be installed: `pip install debugpy`
 - The system will auto-detect Python path or use `PYTHON_PATH` env var
 
+### Ruby
+- Ruby 2.7+ must be installed (3.1+ recommended — bundles the debug gem)
+- The `debug` gem (rdbg) must be available: `gem install debug`
+- Auto-detects ruby/rdbg from PATH and common install locations, or use `RUBY_PATH`/`RDBG_PATH` env vars
+- Launch always stops at load (the entry pause is auto-continued for `stopOnEntry=false`); attach connects directly to a running `rdbg --open` DAP socket without spawning an adapter process, including remote targets via port mapping/`kubectl port-forward` (see `docs/ruby/README.md`)
+- On Windows, rdbg's `.bat` shim is bypassed by running the sibling rdbg script via the Ruby interpreter (Node cannot spawn `.bat` without a shell)
+
 ### JavaScript/Node.js
 - Node.js 22+ must be installed
 - Uses bundled js-debug adapter (VSCode's debugger)
@@ -478,4 +488,4 @@ Once connected, the following 21 MCP tools become available:
   # Should return clean JSON without any log messages
   ```
 - **Verify Python and debugpy are installed**: `python3 -m debugpy --version`
-- **Check logs if needed**: Set `DEBUG=debug-mcp:*` environment variable (only for troubleshooting, not for normal operation)
+- **Check logs if needed**: Set `DEBUG=debug-mcp:*` environment variable (only for troubleshooting, not for normal operation)
@@ -4,7 +4,7 @@
   <img src="assets/logo.png" alt="MCP Debugger Logo - A stylized circuit board with debug breakpoints" width="400" height="400">
 </div>
 
-**A headless, agentic debugger over MCP — let your AI agents debug running programs in six languages.**
+**A headless, agentic debugger over MCP — let your AI agents debug running programs in seven languages.**
 
 [![CI](https://github.com/debugmcp/mcp-debugger/actions/workflows/ci.yml/badge.svg)](https://github.com/debugmcp/mcp-debugger/actions/workflows/ci.yml)
 [![codecov](https://codecov.io/gh/debugmcp/mcp-debugger/branch/main/graph/badge.svg)](https://codecov.io/gh/debugmcp/mcp-debugger)
@@ -15,21 +15,22 @@
 
 ## 🎯 Overview
 
-mcp-debugger is a Model Context Protocol (MCP) server that exposes step-through debugging as structured tool calls. It lets AI agents set breakpoints, inspect variables, evaluate expressions, and step through running programs across six languages — driving real language debuggers through the Debug Adapter Protocol (DAP).
+mcp-debugger is a Model Context Protocol (MCP) server that exposes step-through debugging as structured tool calls. It lets AI agents set breakpoints, inspect variables, evaluate expressions, and step through running programs across seven languages — driving real language debuggers through the Debug Adapter Protocol (DAP).
 
 > 🆕 **v0.21.0** — the minimum runtime is now **Node.js 22+** (Node 20 reached end-of-life). See the [CHANGELOG](./CHANGELOG.md) for the full release history.
 
 ## ✨ Key Features
 
 - 🌐 **Multi-language support** – Clean adapter pattern for any language
 - 🐍 **Python debugging via debugpy** – Full DAP protocol support
+- 💎 **Ruby debugging via rdbg** – Launch and attach workflows, including remote attach to containers and Kubernetes pods
 - 🟨 **JavaScript (Node.js) debugging via js-debug** – VSCode's proven debugger
 - 🦀 **Rust debugging via CodeLLDB** – Debug Rust & Cargo projects (Linux/macOS; Windows needs the GNU toolchain — see [Rust on Windows](docs/rust-debugging-windows.md))
 - 🐹 **Go debugging via Delve** – Full DAP support for Go programs
 - ☕ **Java debugging via JDI bridge** – Launch and attach modes with JDK 21+
 - 🔷 **.NET/C# debugging via netcoredbg** – Debug .NET applications with full DAP support
 - 🧪 **Mock adapter for testing** – Test without external dependencies
-- 🛰️ **Out-of-IDE & remote attach** – Attach over host/port to a process on another machine or inside a container (Python via debugpy, Java via JDWP), with source-path mapping
+- 🛰️ **Out-of-IDE & remote attach** – Attach over host/port to a process on another machine or inside a container (Python via debugpy, Ruby via rdbg, Java via JDWP), with source-path mapping
 - 🔌 **STDIO and Streamable HTTP transports** – Works with any MCP client (legacy SSE transport is deprecated)
 - 📦 **Zero-runtime dependencies** – Self-contained bundles via esbuild + tsup
 - ⚡ **npx ready** – Run directly with `npx @debugmcp/mcp-debugger` - no installation needed
@@ -41,7 +42,7 @@ mcp-debugger is a Model Context Protocol (MCP) server that exposes step-through
 
 ## 🚀 Quick Start
 
-> **Requirements:** Node.js 22+ for the server. Each language you debug also needs its own toolchain installed (Python + debugpy, Node.js, Go + Delve, JDK 21+, .NET SDK, or the Rust toolchain).
+> **Requirements:** Node.js 22+ for the server. Each language you debug also needs its own toolchain installed (Python + debugpy, Ruby + the `debug` gem / `rdbg`, Node.js, Go + Delve, JDK 21+, .NET SDK, or the Rust toolchain).
 
 ### For MCP Clients (Claude Desktop, etc.)
 
@@ -108,7 +109,7 @@ mcp-debugger exposes debugging operations as MCP tools that can be called with s
 // Tool: create_debug_session
 // Request:
 {
-  "language": "python",  // or "javascript", "rust", "go", "java", "dotnet", or "mock" for testing
+  "language": "python",  // or "ruby", "javascript", "rust", "go", "java", "dotnet", or "mock" for testing
   "name": "My Debug Session"
 }
 // Response:
@@ -307,6 +308,7 @@ Then get the local variables:
 - 🧩 [Adapter API Reference](./docs/architecture/adapter-api-reference.md) – Adapter, factory, loader, and registry contracts
 - 🔄 [Migration Guide](./docs/migration-guide.md) – Upgrading to v0.15.0 (dynamic loading)
 - 🐍 [Python Debugging Guide](./docs/python/README.md) – Python-specific features
+- 💎 [Ruby Debugging Guide](./docs/ruby/README.md) – Ruby debugging with `rdbg`, including remote attach
 - 🟨 [JavaScript Debugging Guide](./docs/javascript/README.md) – JavaScript/TypeScript features
 - 🐹 [Go Debugging Guide](./docs/go/README.md) – Go debugging with Delve
 - ☕ [Java Debugging Guide](./docs/java/README.md) – Java debugging with JDI bridge
@@ -377,9 +379,9 @@ See [tests/README.md](./tests/README.md) for detailed testing instructions.
 
 ## 📊 Project Status
 
-- ✅ **Production Ready**: v0.21.0 with six language adapters and polished multi-language distribution
+- ✅ **Production Ready**: v0.21.0 with seven language adapters and polished multi-language distribution
 - ✅ **Clean architecture** with a dynamic adapter pattern
-- ✅ **Python · JavaScript/TypeScript · Go · Java · .NET/C#**: Full step-through debugging
+- ✅ **Python · Ruby · JavaScript/TypeScript · Go · Java · .NET/C#**: Full step-through debugging
 - 🦀 **Rust**: Full support on Linux/macOS/Windows (Windows requires the GNU toolchain; MSVC is not supported by CodeLLDB)
 - 🟢 **Runtime**: Node.js 22+
 - 📈 **Active Development**: Regular updates and improvements
@@ -390,6 +392,7 @@ MIT License - see [LICENSE](./LICENSE) for details.
 
 ## 👥 Contributors
 
+- [@Poyraxx](https://github.com/Poyraxx) — Ruby adapter (rdbg)
 - [@swinyx](https://github.com/swinyx) — Go adapter (Delve)
 - [@roofpig95008](https://github.com/roofpig95008) — Java adapter (JDI bridge)
 
@@ -399,6 +402,7 @@ Built with:
 - [Model Context Protocol](https://github.com/anthropics/model-context-protocol) by Anthropic
 - [Debug Adapter Protocol](https://microsoft.github.io/debug-adapter-protocol/) by Microsoft
 - [debugpy](https://github.com/microsoft/debugpy) for Python debugging
+- [debug](https://github.com/ruby/debug) for Ruby debugging
 
 ---
 
 
@@ -1,6 +1,6 @@
 # MCP Debugger Usage Guide for AI Agents
 
-This guide explains how to correctly use the MCP Debugger tools when testing debugging functionality across all supported languages (Python, JavaScript, Rust, Go, Java, .NET/C#).
+This guide explains how to correctly use the MCP Debugger tools when testing debugging functionality across all supported languages (Python, Ruby, JavaScript, Rust, Go, Java, and .NET/C#).
 
 ## Key Concepts
 
@@ -208,6 +208,25 @@ frame_id = stack["stackFrames"][0]["id"]
 get_local_variables(sessionId=session_id)
 ```
 
+## Ruby Debugging
+
+**Prerequisites**: Ruby 2.7+ installed. `rdbg` must be available through the standard `debug` gem.
+
+**Testing sequence:**
+```python
+# 1. Create session
+session_id = create_debug_session(language="ruby")
+
+# 2. Set breakpoint
+set_breakpoint(sessionId=session_id, file="/path/to/app.rb", line=12)
+
+# 3. Start debugging
+start_debugging(sessionId=session_id, scriptPath="/path/to/app.rb")
+
+# 4. Inspect variables
+get_local_variables(sessionId=session_id)
+```
+
 ## Go Debugging
 
 **Prerequisites**: Go 1.18+ installed. Delve debugger must be installed: `go install github.com/go-delve/delve/cmd/dlv@latest`.
@@ -284,9 +303,10 @@ get_local_variables(sessionId=session_id)
 
 ## Summary
 
-The MCP Debugger is fully functional for Python, JavaScript, Rust, Go, Java, and .NET/C#. The key insights are:
+The MCP Debugger is fully functional for Python, Ruby, JavaScript, Rust, Go, Java, and .NET/C#. The key insights are:
 - **JavaScript**: Stack trace filtering hides internal frames; may need `continue_execution` if initially stopped at internals
 - **Python**: Use variablesReference to expand variable containers
+- **Ruby**: Supports launch and attach flows through `rdbg`; use Bundler mode for Rails and RSpec-style entrypoints
 - **Rust**: CodeLLDB adapter is vendored; the GNU toolchain is required for reliable debugging -- MSVC-built binaries may produce errors with CodeLLDB. Set `RUST_MSVC_BEHAVIOR` env var to control MSVC handling
 - **Go**: Uses Delve's native DAP support
 - **Java**: Use FQCN for breakpoints, pass `mainClass`/`classpath` via `dapLaunchArgs`
 
@@ -49,6 +49,7 @@ Each supported language implements the IDebugAdapter interface:
 
 - **[MockDebugAdapter](../../packages/adapter-mock/)** - Reference implementation for testing
 - **[PythonDebugAdapter](../../packages/adapter-python/)** - Python/debugpy support
+- **[RubyDebugAdapter](../../packages/adapter-ruby/)** - Ruby/rdbg support
 - **[JavascriptDebugAdapter](../../packages/adapter-javascript/)** - JavaScript/Node.js support
 - **[RustDebugAdapter](../../packages/adapter-rust/)** - Rust/CodeLLDB support
 - **[GoDebugAdapter](../../packages/adapter-go/)** - Go/Delve support
@@ -261,6 +262,7 @@ async endSession(exitCode: number) {
 
 ## Version History
 
+- **v0.21.0** - Ruby adapter, 8 adapters total
 - **v0.19.0** - .NET/C# adapter, 7 language adapters total
 - **v0.18.0** - Go adapter, Java adapter
 - **v0.17.0** - Rust adapter
 
@@ -2,7 +2,7 @@
 
 ## Overview
 
-The Debug Adapter Pattern powers mcp-debugger as a multi-language debugging platform supporting 7 languages (Python, JavaScript, Rust, Go, Java, .NET/C#, and Mock). This design uses a **dual-pattern architecture** that combines two complementary adapter patterns:
+The Debug Adapter Pattern powers mcp-debugger as a multi-language debugging platform supporting 7 programming languages plus a mock adapter (Python, Ruby, JavaScript, Rust, Go, Java, and .NET/C#). This design uses a **dual-pattern architecture** that combines two complementary adapter patterns:
 
 1. **IDebugAdapter Interface**: Complete adapter implementations for full language support
 2. **AdapterPolicy Interface**: Lightweight policies for language-specific session management behaviors
@@ -87,6 +87,7 @@ graph TD
     
     subgraph "Language Adapters"
         PA[PythonAdapter]
+        RBA[RubyAdapter]
         NA[JavascriptAdapter]
         RA[RustAdapter]
         GA[GoAdapter]
@@ -96,6 +97,7 @@ graph TD
     end
 
     AR --> PA
+    AR --> RBA
     AR --> NA
     AR --> RA
     AR --> GA
 
@@ -1,6 +1,6 @@
 # Getting Started with Debug MCP Server
 
-This guide will walk you through testing the Debug MCP Server locally with a simple Python example. The server also supports JavaScript, Rust, Go, Java, and .NET/C# debugging -- see the language-specific guides for details.
+This guide will walk you through testing the Debug MCP Server locally with a simple Python example. The server also supports Ruby, JavaScript, Rust, Go, Java, and .NET/C# debugging -- see the language-specific guides for details.
 
 ## Prerequisites