claude_code_sdk 0.1.0

data/lib/claude_code_sdk/transport/simple_cli.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+require "English"
+require "json"
+require "shellwords"
+
+module ClaudeCodeSDK
+  module Transport
+    class SimpleCLI < Base
+      def initialize(prompt:, options: nil)
+        @prompt = prompt
+        @options = options || Options.new
+        @connected = false
+      end
+
+      def connect
+        @connected = true
+      end
+
+      def disconnect
+        @connected = false
+      end
+
+      def connected?
+        @connected
+      end
+
+      def receive_messages
+        cli_path = find_cli_path
+        raise CLINotFoundError.new(cli_path: cli_path) unless cli_path
+
+        args = @options.to_cli_args
+        args.push(@prompt)
+
+        command = "#{cli_path} #{args.map { |arg| Shellwords.escape(arg) }.join(" ")}"
+        puts "[DEBUG] Command: #{command}" if ENV["DEBUG"]
+
+        # Set environment variable
+        env = { "ANTHROPIC_API_KEY" => ENV.fetch("ANTHROPIC_API_KEY", nil) }
+
+        # Run command and capture output
+        output = IO.popen(env, command, "r", &:read)
+        exit_status = $CHILD_STATUS.exitstatus
+
+        puts "[DEBUG] Exit status: #{exit_status}" if ENV["DEBUG"]
+        puts "[DEBUG] Output: #{output}" if ENV["DEBUG"]
+
+        # Check for errors
+        unless $CHILD_STATUS.success?
+          raise ProcessError.new(
+            "Claude Code process failed",
+            exit_code: exit_status,
+            stderr: output
+          )
+        end
+
+        # Parse the JSON response
+        begin
+          data = JSON.parse(output, symbolize_names: true)
+
+          # The response is a single result object, but we need to yield messages
+          if data[:type] == "result" && data[:result]
+            # Yield a user message with the prompt
+            yield({ type: "user", text: @prompt })
+
+            # Yield an assistant message with the response
+            yield({
+              type: "assistant",
+              message: {
+                id: "msg-#{data[:session_id]}",
+                content: [{ type: "text", text: data[:result] }]
+              }
+            })
+
+            # Yield the result message
+            yield data
+          end
+        rescue JSON::ParserError
+          raise CLIJSONDecodeError.new(
+            "Failed to parse JSON from Claude Code",
+            line: output
+          )
+        end
+      end
+
+      private
+
+      def find_cli_path
+        # Check if claude-code or claude is in PATH
+        %w[claude-code claude].each do |name|
+          path = `which #{name} 2>/dev/null`.chomp
+          return path unless path.empty?
+        end
+
+        # Check common installation locations
+        common_paths = [
+          File.expand_path("~/bin/claude-code"),
+          File.expand_path("~/bin/claude"),
+          "/usr/local/bin/claude-code",
+          "/usr/local/bin/claude",
+          "/opt/claude-code/bin/claude-code"
+        ]
+
+        common_paths.find { |p| File.executable?(p) }
+      end
+    end
+  end
+end

data/lib/claude_code_sdk/transport/subprocess_cli.rb

@@ -0,0 +1,167 @@
+# frozen_string_literal: true
+
+require "open3"
+require "json"
+require "stringio"
+
+module ClaudeCodeSDK
+  module Transport
+    class SubprocessCLI < Base
+      BUFFER_SIZE = 1024 * 1024 # 1MB
+      STDERR_TIMEOUT = 5 # seconds
+
+      def initialize(prompt:, options: nil)
+        @prompt = prompt
+        @options = options || Options.new
+        @process = nil
+        @stdin = nil
+        @stdout = nil
+        @stderr = nil
+        @wait_thread = nil
+      end
+
+      def connect
+        return if @connected
+
+        cli_path = find_cli_path
+        raise CLINotFoundError.new(cli_path: cli_path) unless cli_path
+
+        args = @options.to_cli_args
+        args.push("--print", @prompt) # Add prompt after --print
+
+        command = [cli_path] + args
+        puts "[DEBUG] Command: #{command.join(" ")}" if ENV["DEBUG"]
+
+        env = { "ANTHROPIC_API_KEY" => ENV.fetch("ANTHROPIC_API_KEY", nil) }
+        env["CLAUDE_CODE_ENTRYPOINT"] = "sdk-ruby"
+
+        popen_options = { chdir: @options.cwd }.compact
+        @stdin, @stdout, @stderr, @wait_thread = Open3.popen3(env, *command, **popen_options)
+        @stdin.close # Close stdin since we pass all data via args
+        @connected = true
+      rescue Errno::ENOENT
+        raise CLINotFoundError.new("Claude Code CLI not found", cli_path: cli_path)
+      end
+
+      def disconnect
+        return unless @connected
+
+        @stdin&.close unless @stdin&.closed?
+        @stdout&.close unless @stdout&.closed?
+        @stderr&.close unless @stderr&.closed?
+
+        if @wait_thread&.alive?
+          begin
+            Process.kill("TERM", @wait_thread.pid)
+            @wait_thread.join(5)
+          rescue Errno::ESRCH
+            # Process already finished
+          end
+        end
+
+        @process = nil
+        @connected = false
+      end
+
+      def connected?
+        @connected && @wait_thread&.alive?
+      rescue Errno::ESRCH
+        false
+      end
+
+      def receive_messages
+        connect unless @connected
+
+        json_buffer = ""
+
+        # Read streaming JSON from stdout
+        puts "[DEBUG] Reading streaming JSON..." if ENV["DEBUG"]
+
+        begin
+          @stdout.each_line do |line|
+            line_str = line.strip
+            next if line_str.empty?
+
+            puts "[DEBUG] Read line: #{line_str}" if ENV["DEBUG"]
+
+            json_buffer += line_str
+
+            begin
+              data = JSON.parse(json_buffer, symbolize_names: true)
+              json_buffer = ""
+              puts "[DEBUG] Parsed message: #{data[:type]}" if ENV["DEBUG"]
+              yield data
+            rescue JSON::ParserError
+              # Continue accumulating until we have valid JSON
+              next
+            end
+          end
+        rescue IOError => e
+          puts "[DEBUG] IOError reading stdout: #{e.message}" if ENV["DEBUG"]
+        end
+
+        # Handle process completion
+        puts "[DEBUG] Waiting for process to complete..." if ENV["DEBUG"]
+        @wait_thread.join
+        exit_status = @wait_thread.value.exitstatus
+
+        puts "[DEBUG] Process exited with status: #{exit_status}" if ENV["DEBUG"]
+
+        unless exit_status.zero?
+          stderr_output = @stderr.read
+          puts "[DEBUG] stderr: #{stderr_output}" if ENV["DEBUG"]
+          raise ProcessError.new(
+            "Claude Code process failed",
+            exit_code: exit_status,
+            stderr: stderr_output
+          )
+        end
+      ensure
+        disconnect
+      end
+
+      private
+
+      def find_cli_path
+        # Check if claude-code or claude is in PATH
+        %w[claude-code claude].each do |name|
+          path = `which #{name} 2>/dev/null`.chomp
+          return path unless path.empty?
+        end
+
+        # Check common installation locations
+        common_paths = [
+          File.expand_path("~/bin/claude-code"),
+          File.expand_path("~/bin/claude"),
+          "/usr/local/bin/claude-code",
+          "/usr/local/bin/claude",
+          "/opt/claude-code/bin/claude-code"
+        ]
+
+        common_paths.find { |p| File.executable?(p) }
+      end
+
+      def read_stderr_with_timeout
+        content = StringIO.new
+        start_time = Time.now
+
+        while (Time.now - start_time) < STDERR_TIMEOUT
+          begin
+            chunk = @stderr.read_nonblock(1024)
+            content.write(chunk)
+
+            # Stop if buffer is too large
+            break if content.size > BUFFER_SIZE
+          rescue IO::WaitReadable
+            # No data available, check if we should continue
+            break unless @stderr.wait_readable(0.1)
+          rescue EOFError
+            break
+          end
+        end
+
+        content.string
+      end
+    end
+  end
+end

data/lib/claude_code_sdk/types.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module ClaudeCodeSDK
+  # Options for configuring Claude Code queries
+  class Options
+    attr_accessor :allowed_tools, :blocked_tools, :permission_mode,
+                  :max_thinking_tokens, :system_prompt, :cwd,
+                  :mcp_servers, :disable_cache, :no_markdown,
+                  :tree, :tree_symlinks, :tree_verbose,
+                  :max_turns, :model, :continue_conversation,
+                  :resume, :append_system_prompt
+
+    def initialize(**kwargs)
+      @allowed_tools = kwargs[:allowed_tools] || []
+      @blocked_tools = kwargs[:blocked_tools] || []
+      @permission_mode = kwargs[:permission_mode] || "default"
+      @max_thinking_tokens = kwargs[:max_thinking_tokens] || 8000
+      @system_prompt = kwargs[:system_prompt]
+      @cwd = kwargs[:cwd]
+      @mcp_servers = kwargs[:mcp_servers] || {}
+      @disable_cache = kwargs[:disable_cache] || false
+      @no_markdown = kwargs[:no_markdown] || false
+      @tree = kwargs[:tree] || []
+      @tree_symlinks = kwargs[:tree_symlinks] || false
+      @tree_verbose = kwargs[:tree_verbose] || false
+      @max_turns = kwargs[:max_turns]
+      @model = kwargs[:model]
+      @continue_conversation = kwargs[:continue_conversation] || false
+      @resume = kwargs[:resume]
+      @append_system_prompt = kwargs[:append_system_prompt]
+    end
+
+    def to_cli_args
+      args = ["--output-format", "stream-json", "--verbose"]
+
+      args.push("--system-prompt", system_prompt) if system_prompt
+      args.push("--append-system-prompt", append_system_prompt) if append_system_prompt
+      args.push("--allowedTools", allowed_tools.join(",")) unless allowed_tools.empty?
+      args.push("--disallowedTools", blocked_tools.join(",")) unless blocked_tools.empty?
+      args.push("--max-turns", max_turns.to_s) if max_turns
+      args.push("--model", model) if model
+      args.push("--permission-mode", permission_mode) if permission_mode
+      args.push("--continue") if continue_conversation
+      args.push("--resume", resume) if resume
+      args.push("--add-dir", cwd.to_s) if cwd
+
+      unless mcp_servers.empty?
+        require "json"
+        mcp_config = { mcpServers: mcp_servers }.to_json
+        args.push("--mcp-config", mcp_config)
+      end
+
+      args
+    end
+  end
+
+  # Permission modes
+  module PermissionMode
+    DEFAULT = "default"
+    ACCEPT_EDITS = "acceptEdits"
+    BYPASS_PERMISSIONS = "bypassPermissions"
+  end
+end

data/lib/claude_code_sdk/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module ClaudeCodeSDK
+  VERSION = "0.1.0"
+end

data/lib/claude_code_sdk.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+require "pathname"
+require_relative "claude_code_sdk/version"
+require_relative "claude_code_sdk/errors"
+require_relative "claude_code_sdk/types"
+require_relative "claude_code_sdk/messages"
+require_relative "claude_code_sdk/configuration"
+require_relative "claude_code_sdk/transport/base"
+require_relative "claude_code_sdk/transport/subprocess_cli"
+require_relative "claude_code_sdk/internal/client"
+
+module ClaudeCodeSDK
+  # Set environment variable for SDK identification
+  ENV["CLAUDE_CODE_SDK"] = "ruby/#{VERSION}"
+
+  class << self
+    # Query Claude Code with a prompt
+    #
+    # @param prompt [String] The prompt to send to Claude
+    # @param options [ClaudeCodeSDK::Options, Hash, nil] Configuration options
+    # @yield [Message] Messages from the conversation
+    # @return [Array<Message>] All messages if no block given
+    #
+    # @example With a block
+    #   ClaudeCodeSDK.query("Hello Claude") do |message|
+    #     puts message.text if message.is_a?(AssistantMessage)
+    #   end
+    #
+    # @example Without a block
+    #   messages = ClaudeCodeSDK.query("Hello Claude")
+    #   messages.each { |msg| puts msg }
+    #
+    # @example With options
+    #   ClaudeCodeSDK.query("Help me code",
+    #     system_prompt: "You are a Ruby expert",
+    #     allowed_tools: ["read_file", "write_file"]
+    #   )
+    def query(prompt, options = nil, &block)
+      # Convert hash to Options if needed
+      options = Options.new(**options) if options.is_a?(Hash)
+
+      client = Internal::Client.new
+
+      if block_given?
+        client.query(prompt: prompt, options: options, &block)
+      else
+        messages = []
+        client.query(prompt: prompt, options: options) { |msg| messages << msg }
+        messages
+      end
+    end
+
+    # Convenience method for simple text queries
+    #
+    # @param prompt [String] The prompt to send
+    # @return [String] The concatenated text response
+    def ask(prompt)
+      response_text = []
+
+      query(prompt) do |message|
+        if message.is_a?(AssistantMessage)
+          message.content.each do |block|
+            response_text << block.text if block.is_a?(Content::TextBlock)
+          end
+        end
+      end
+
+      response_text.join("\n")
+    end
+
+    # Configure global defaults
+    #
+    # @yield [Configuration] The configuration object
+    # @example
+    #   ClaudeCodeSDK.configure do |config|
+    #     config.default_system_prompt = "You are helpful"
+    #     config.default_cwd = "/home/user/projects"
+    #   end
+    def configure
+      yield Configuration.instance
+    end
+  end
+end

metadata

@@ -0,0 +1,262 @@
+--- !ruby/object:Gem::Specification
+name: claude_code_sdk
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Tanooki Labs LLC
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-07-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.20'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.20'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.19'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.19'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: async
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: sorbet-runtime
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+description: A Ruby port of the official Python SDK for Claude Code. This gem provides
+  a clean, idiomatic Ruby interface for interacting with Anthropic's Claude Code AI
+  assistant through the command-line interface.
+email:
+- hello@tanookilabs.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- ".yardopts"
+- CHANGELOG.md
+- CLAUDE.md
+- CONTRIBUTING.md
+- LICENSE
+- README.md
+- Rakefile
+- claude_code_sdk.gemspec
+- examples/debug_process.rb
+- examples/debug_query.rb
+- examples/simple_query.rb
+- examples/simple_test.rb
+- examples/simple_tools.rb
+- examples/simple_tools_fixed.rb
+- examples/streaming_responses.rb
+- examples/test_sdk.rb
+- examples/with_tools.rb
+- lib/claude_code_sdk.rb
+- lib/claude_code_sdk/configuration.rb
+- lib/claude_code_sdk/errors.rb
+- lib/claude_code_sdk/internal/client.rb
+- lib/claude_code_sdk/messages.rb
+- lib/claude_code_sdk/transport/base.rb
+- lib/claude_code_sdk/transport/simple_cli.rb
+- lib/claude_code_sdk/transport/subprocess_cli.rb
+- lib/claude_code_sdk/types.rb
+- lib/claude_code_sdk/version.rb
+homepage: https://github.com/TanookiLabs/claude-code-sdk-ruby
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/TanookiLabs/claude-code-sdk-ruby
+  source_code_uri: https://github.com/TanookiLabs/claude-code-sdk-ruby
+  changelog_uri: https://github.com/TanookiLabs/claude-code-sdk-ruby/blob/main/CHANGELOG.md
+  documentation_uri: https://www.rubydoc.info/gems/claude_code_sdk
+  bug_tracker_uri: https://github.com/TanookiLabs/claude-code-sdk-ruby/issues
+  rubygems_mfa_required: 'true'
+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.4.10
+signing_key:
+specification_version: 4
+summary: Ruby SDK for Claude Code - AI-powered coding assistant
+test_files: []