Update README, lint, and get CI working to auto-publish

Author: keithschacht

.github/workflows/ci.yml

@@ -37,7 +37,17 @@ jobs:
           ruby-version: '3.4'
           bundler-cache: true
 
+      - name: Cache Claude CLI
+        id: cache-claude
+        uses: actions/cache@v4
+        with:
+          path: ~/.local/bin/claude
+          key: claude-cli-${{ runner.os }}-${{ hashFiles('**/lockfile') || 'weekly' }}-${{ github.run_number % 100 }}
+          restore-keys: |
+            claude-cli-${{ runner.os }}-
+
       - name: Install Claude Code CLI
+        if: steps.cache-claude.outputs.cache-hit != 'true'
         run: curl -fsSL https://claude.ai/install.sh | bash
 
       - name: Add Claude to PATH

README.md

@@ -37,28 +37,13 @@ gem 'ruby_agent'
 ```ruby
 require 'ruby_agent'
 
-agent = RubyAgent.new(
-  system_prompt: "You are a helpful assistant",
-  model: "claude-sonnet-4-5-20250929"
-)
-
-agent.on_assistant do |event, all_events|
-  if event.dig("message", "content", 0, "type") == "text"
-    text = event.dig("message", "content", 0, "text")
-    puts "Assistant: #{text}"
-  end
-end
-
-agent.on_result do |event, all_events|
-  puts "Result: #{event['subtype']}"
-  agent.exit if event["subtype"] == "success"
-end
-
-agent.connect do
-  agent.ask("What is 1+1?", sender_name: "User")
-end
+agent = RubyAgent.new
+agent.on_result { |e, _| agent.exit if e["subtype"] == "success" }
+agent.connect { agent.ask("What is 2+2?") }
 ```
 
+That's it! Three lines to create an agent, ask Claude a question, and exit when done.
+
 ### Advanced Example with Callbacks
 
 ```ruby
@@ -219,9 +204,10 @@ end
 rake ci
 
 # Or run tasks individually:
-rake ci:test   # Run test suite
-rake ci:lint   # Run RuboCop linter
-rake ci:scan   # Run security audit
+rake ci:test      # Run test suite
+rake ci:lint      # Run RuboCop linter
+rake ci:lint:fix  # Auto-fix linting issues
+rake ci:scan      # Run security audit
 ```
 
 5. Commit your changes: `git commit -am 'Add some feature'`
@@ -251,7 +237,7 @@ We use RuboCop for code linting:
 rake ci:lint
 
 # Auto-fix linting issues
-bundle exec rubocop -a
+rake ci:lint:fix
 ```
 
 ### Publishing

Rakefile

@@ -15,19 +15,25 @@ namespace :ci do
     sh "bundle exec rake test"
   end
 
-  desc "Run linter"
-  task :lint do
-    sh "bundle exec rubocop"
-  rescue StandardError
-    puts "Rubocop not configured yet, skipping..."
+  namespace :lint do
+    desc "Run linter"
+    task :default do
+      sh "bundle exec rubocop"
+    end
+
+    desc "Auto-fix linting issues"
+    task :fix do
+      sh "bundle exec rubocop -a"
+    end
   end
 
   desc "Run security scan"
   task :scan do
     sh "bundle exec bundler-audit check --update"
-  rescue StandardError
-    puts "Bundler-audit not installed, skipping..."
   end
+
+  # alias ci:lint to ci:lint:default
+  task lint: "lint:default"
 end
 
 desc "Run all CI tasks"