openclacky 0.7.4 → 0.7.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d4cbc9f7d1de1e64b78bd09ac59e9d911d101ab4e5e4bc6a2e869810311fffbc
-  data.tar.gz: 26de964a5a19c4eacf6a2fecff08dd6fe0dcdcc5baacb435fd53ed30095860cb
+  metadata.gz: f623e852b5705d9339509514773528e2937fe90fe1fb8feca214a44633aa4d8d
+  data.tar.gz: bfff8a16fc705012a2d30a4ea8ac9a90ac6506ddbd45d9f30debe6019d04c52c
 SHA512:
-  metadata.gz: fdefc255c000713dc69b8062ce8a1e249fbbfe219716dcae1bc16c2ad32a5672080216172f63b4648f30680f9b4295e8cd3a717d0f7d05fc17f93922cc35227e
-  data.tar.gz: e650a5ef793d1c435ab23436f407bfff1a76def00a6047c0d6e75fbc13e41dcc5bc3b5ec538b6eef39a928d4dc5339c1c5b3f69da242b12b2fe8d4c59e51e381
+  metadata.gz: 06cf4fe9c03e899ad4f9ccf6a325c10c1c952179240e37d5f18bd9c40b3d0088a4928c2536c578ea4735a606e55d3b5d58ffe9c19d21830f5589e002c99b887a
+  data.tar.gz: aa8bf7a73ca171fc1a234bfd3fac2ed51db67c18610fa525179d656186853d00023b0835d8bc7590c772f57563957299968f540239c1d736057d43dcd9f4488c

data/.clacky/skills/gem-release/SKILL.md

@@ -88,9 +88,28 @@ To use this skill, simply say:
    git push origin main --tags
    ```
 
-4. **Verify Publication**
+4. **Create GitHub Release**
+
+   Extract the release notes for this version from CHANGELOG.md, then create a GitHub Release:
+   ```bash
+   gh release create v{version} \
+     --title "v{version}" \
+     --notes-file /tmp/release_notes.md \
+     --latest
+   ```
+
+   Steps:
+   - Parse the CHANGELOG.md section for `[{version}]`
+   - Write it to a temp file (e.g., `/tmp/release_notes_{version}.md`) to avoid shell escaping issues
+   - Run `gh release create` with `--notes-file`
+   - Verify the release appears at: `https://github.com/clacky-ai/open-clacky/releases`
+
+   > **Prerequisite**: `gh` CLI must be installed (`brew install gh`) and authenticated (`gh auth login`)
+
+5. **Verify Publication**
    - Check gem appears on RubyGems.org
    - Verify version information is correct
+   - Confirm GitHub Release is visible at the releases page
 
 ### 6. Documentation - CHANGELOG Writing Process
 
@@ -201,6 +220,15 @@ git commit -m "chore: bump version to X.Y.Z"
 git tag vX.Y.Z
 git push origin main
 git push origin --tags
+
+# Create GitHub Release (requires gh CLI)
+# 1. Extract release notes from CHANGELOG.md for this version
+# 2. Write to temp file to avoid shell escaping issues
+# 3. Create the release
+gh release create vX.Y.Z \
+  --title "vX.Y.Z" \
+  --notes-file /tmp/release_notes_X.Y.Z.md \
+  --latest
 ```
 
 ## File Locations
@@ -218,6 +246,7 @@ git push origin --tags
 - New version successfully published to RubyGems
 - Git repository updated with version tag
 - CHANGELOG.md updated with release notes
+- GitHub Release created and visible at https://github.com/clacky-ai/open-clacky/releases
 - No build or deployment errors
 
 ## Error Handling
@@ -227,6 +256,8 @@ git push origin --tags
 - If gem build fails, check gemspec configuration
 - If git push fails, verify repository permissions
 - If gem push fails, check RubyGems credentials
+- If `gh release create` fails, ensure `gh` CLI is installed (`brew install gh`) and authenticated (`gh auth login`)
+- If GitHub Release notes look wrong, check CHANGELOG.md formatting for the version section
 
 ## Notes
 
@@ -241,6 +272,7 @@ git push origin --tags
 - Git repository access
 - RubyGems account with push permissions
 - Bundle and RSpec for testing
+- `gh` CLI installed and authenticated (`brew install gh && gh auth login`)
 
 ## Version History
 

data/CHANGELOG.md

@@ -7,6 +7,45 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.5] - 2026-02-28
+
+### Fixed
+- Tool errors now display in low-key style (same as tool result) to avoid alarming users for non-critical errors the agent can retry
+- Session list now shows last message instead of first message for better context
+- Shell tool uses login shell (`-l`) instead of interactive shell (`-i`) for proper environment variable loading
+
+### Improved
+- Shell tool now reliably loads user environment (PATH, rbenv, nvm, etc.) on every execution
+- Session list shows resume tip (`clacky -a <session_id>`) to help users continue previous sessions
+
+### More
+- Add GitHub Release creation step to gem-release skill
+- Remove debug logging from API client
+
+## [0.7.4] - 2026-02-27
+
+### Added
+- Real-time command output viewing with Ctrl+O hotkey
+- GitHub skill installation support in skill-add
+- Rails project creation scripts in new skill
+- Auto-create ~/clacky_workspace when starting from home directory
+
+### Improved
+- System prompt with glob tool usage guidance
+- Commit skill with holistic grouping strategy and purpose-driven commits
+- Theme color support for light backgrounds (bright mode refinements)
+- Shell output handling and preview functionality
+- Message compressor optimization (reduced to 200)
+
+### Fixed
+- UI2 output re-rendering on modal close and height changes
+- Double render issue in inline input cleanup
+- Small terminal width handling for logo display
+- Extra newline in question display
+
+### More
+- Commented out idle timer debug logs for cleaner output
+
 ## [0.7.3] - 2026-02-26
 
 ### Fixed

data/lib/clacky/cli.rb

@@ -273,8 +273,9 @@ module Clacky
           is_current_dir = session[:working_dir] == working_dir
 
           dir_marker = is_current_dir ? "📍" : "  "
-          say "#{dir_marker} #{index + 1}. [#{session_id}] #{created_at} (#{tasks} tasks, $#{cost.round(4)}) - #{first_msg}", :cyan
+          say "#{dir_marker} #{index + 1}. [#{session_id}] #{created_at} (#{tasks} tasks, $#{cost.round(4)}) - #{last_msg}", :cyan
         end
+        say "\n\n💡 Use `clacky -a <session_id>` to resume a session.", :yellow
         say ""
       end
 

data/lib/clacky/client.rb

@@ -220,12 +220,6 @@ module Clacky
         end
       end
 
-      # Debug: Save request body to see what we're actually sending
-      if ENV['CLACKY_DEBUG_REQUEST']
-        debug_file = "/tmp/clacky_request_#{Time.now.to_i}.json"
-        File.write(debug_file, JSON.pretty_generate(body))
-      end
-
       response = openai_connection.post("chat/completions") do |req|
         req.body = body.to_json
       end
@@ -238,26 +232,10 @@ module Clacky
       # Convert OpenAI message format to Anthropic format
       body = build_anthropic_body(messages, model, tools, max_tokens, caching_enabled)
 
-      # DEBUG: Always save request body
-      debug_file = "/tmp/clacky_request_body.json"
-      File.write(debug_file, JSON.pretty_generate(body))
-
       response = anthropic_connection.post("v1/messages") do |req|
         req.body = body.to_json
       end
 
-      # Debug response
-      if ENV['CLACKY_DEBUG_REQUEST']
-        timestamp = Time.now.to_i
-        File.write("/tmp/clacky_debug_#{timestamp}.txt", "URL = #{@base_url}/v1/messages\n")
-        File.write("/tmp/clacky_debug_#{timestamp}.txt", "API Key = #{@api_key[0..10]}...\n")
-        File.write("/tmp/clacky_debug_#{timestamp}.txt", "Headers = #{anthropic_connection.headers.inspect}\n")
-        File.open("/tmp/clacky_debug_#{timestamp}.txt", "a") do |f|
-          f.puts "Response status = #{response.status}"
-          f.puts "Response body = #{response.body}"
-        end
-      end
-
       handle_anthropic_response(response)
     end
 
@@ -294,18 +272,6 @@ module Clacky
         anthropic_tools.last[:cache_control] = { type: "ephemeral" }
       end
 
-      # DEBUG: Log tools transformation
-      debug_file = "/tmp/clacky_tools_debug.txt"
-      File.write(debug_file, "Tools Debug:\n")
-      File.write(debug_file, "Input tools count: #{tools&.length || 0}\n", mode: "a")
-      File.write(debug_file, "Anthropic tools count: #{anthropic_tools&.length || 0}\n", mode: "a")
-      if tools&.any?
-        File.write(debug_file, "First input tool: #{JSON.pretty_generate(tools.first)}\n", mode: "a")
-      end
-      if anthropic_tools&.any?
-        File.write(debug_file, "First anthropic tool: #{JSON.pretty_generate(anthropic_tools.first)}\n", mode: "a")
-      end
-
       body = {
         model: model,
         max_tokens: max_tokens,
@@ -317,10 +283,6 @@ module Clacky
 
       body[:tools] = anthropic_tools if anthropic_tools&.any?
 
-      # DEBUG: Log final body
-      File.write(debug_file, "Body has tools: #{body.key?(:tools)}\n", mode: "a")
-      File.write(debug_file, "Body tools count: #{body[:tools]&.length || 0}\n", mode: "a")
-
       body
     end
 
@@ -453,16 +415,6 @@ module Clacky
           }
         end
 
-        # DEBUG: Log what we got
-        debug_file = "/tmp/clacky_anthropic_response.txt"
-        File.write(debug_file, "Response Analysis:\n")
-        File.write(debug_file, "content_blocks count: #{content_blocks.length}\n", mode: "a")
-        File.write(debug_file, "content_block types: #{content_blocks.map { |b| b["type"] }.inspect}\n", mode: "a")
-        File.write(debug_file, "tool_use blocks found: #{content_blocks.select { |b| b["type"] == "tool_use" }.length}\n", mode: "a")
-        File.write(debug_file, "extracted tool_calls: #{tool_calls.length}\n", mode: "a")
-        File.write(debug_file, "finish_reason (raw): #{data["stop_reason"]}\n", mode: "a")
-        File.write(debug_file, "Full content_blocks: #{JSON.pretty_generate(content_blocks)}\n", mode: "a")
-
         # Parse finish reason
         finish_reason = case data["stop_reason"]
         when "end_turn" then "stop"

data/lib/clacky/default_skills/new/SKILL.md

@@ -59,9 +59,18 @@ After the script completes, use the run_project tool to start the server:
 run_project(action: "start")
 ```
 
-This will start the Rails development server in the background. Inform user:
-- Application: http://localhost:3000
-- Admin: http://localhost:3000/admin (admin/admin)
+**Important**: If run_project executes without errors, the server has started successfully. 
+
+Then inform the user and ask what to develop next:
+```
+✨ Rails project created successfully!
+
+The development server is now running at: http://localhost:3000
+
+You can open your browser and visit the URL to see the application.
+
+What would you like to develop next?
+```
 
 ## Error Handling
 - Directory not empty → Ask user confirmation, abort if declined

data/lib/clacky/tools/shell.rb

@@ -78,7 +78,7 @@ module Clacky
         @stderr_buffer = stderr_buffer
 
         begin
-          Open3.popen3(command) do |stdin, stdout, stderr, wait_thr|
+          Open3.popen3(wrap_with_shell(command)) do |stdin, stdout, stderr, wait_thr|
             process_pid = wait_thr.pid
             start_time = Time.now
 
@@ -193,6 +193,15 @@ module Clacky
         end
       end
 
+      # Wrap command in an interactive shell so it loads user's rc files
+      # (e.g. ~/.bashrc, ~/.zshrc) and picks up PATH changes from tools
+      # like nvm, rbenv, brew, etc. Falls back to bash if $SHELL is unset.
+      def wrap_with_shell(command)
+        shell = ENV['SHELL'].to_s
+        shell = '/bin/bash' if shell.empty?
+        "#{shell} -l -c #{Shellwords.escape(command)}"
+      end
+
       def determine_timeouts(command, soft_timeout, hard_timeout)
         # 检查是否是慢命令
         is_slow = SLOW_COMMANDS.any? { |slow_cmd| command.include?(slow_cmd) }

data/lib/clacky/ui2/components/tool_component.rb

@@ -59,14 +59,16 @@ module Clacky
         end
 
         # Render tool error
+        # Use a low-key style (same as tool_result) since most tool errors
+        # (e.g. tool not found, invalid args) are non-critical and the agent can retry.
         # @param data [Hash] Tool error data
         # @return [String] Rendered tool error
         def render_tool_error(data)
-          symbol = format_symbol(:tool_error)
+          symbol = format_symbol(:tool_result)
           error_msg = data[:error] || "Unknown error"
-          text = format_text("Error: #{error_msg}", :tool_error)
+          text = format_text(truncate(error_msg, 200), :tool_result)
 
-          "\n#{symbol} #{text}"
+          "#{symbol} #{text}"
         end
 
         # Render tool denied

data/lib/clacky/ui2/layout_manager.rb

@@ -96,30 +96,30 @@ module Clacky
         @render_mutex.synchronize do
           # Clear entire screen
           screen.clear_screen
-          
+
           # Re-render output from buffer
           render_output_from_buffer
-          
+
           # Re-render fixed areas at new positions
           render_fixed_areas
           screen.flush
         end
       end
-      
+
       # Render output area from buffer (clears and re-renders last N lines)
       private def render_output_from_buffer
         max_output_row = fixed_area_start_row
-        
+
         # Clear output area
         (0...max_output_row).each do |row|
           screen.move_cursor(row, 0)
           screen.clear_line
         end
-        
+
         # Re-render from buffer (show last N lines that fit)
         @output_row = 0
         visible_lines = [@output_buffer.size, max_output_row].min
-        
+
         @output_buffer.last(visible_lines).each do |line|
           screen.move_cursor(@output_row, 0)
           print line
@@ -217,7 +217,7 @@ module Clacky
 
           # Reset output position to beginning
           @output_row = 0
-          
+
           # Clear the output buffer so re-renders don't restore old content
           @output_buffer.clear
 
@@ -349,27 +349,36 @@ module Clacky
 
       # Handle window resize
       private def handle_resize
+        # Record old dimensions before updating to detect shrink vs grow
+        old_height = screen.height
+        old_width = screen.width
+
         # Update terminal dimensions and recalculate layout
         screen.update_dimensions
         calculate_layout
 
-        # Clear entire screen
-        screen.clear_screen
-        
+        # When shrinking: full reset (clears scrollback too), otherwise just clear current screen
+        shrinking = screen.height < old_height || screen.width < old_width
+        screen.clear_screen(mode: shrinking ? :reset : :current)
+
         # Re-render all output from buffer
         @output_row = 0
         max_output_row = fixed_area_start_row
-        
+
         # Calculate how many lines we can show from the end of buffer
         visible_lines = [@output_buffer.size, max_output_row].min
-        
+
         # Render the last N lines that fit in the output area
         @output_buffer.last(visible_lines).each do |line|
           screen.move_cursor(@output_row, 0)
           print line
           @output_row += 1
         end
-        
+
+        # Sync @last_fixed_area_height so render_fixed_areas won't think the height
+        # changed and trigger a second render_output_from_buffer call
+        @last_fixed_area_height = fixed_area_height
+
         # Re-render fixed areas at new positions
         render_fixed_areas
         screen.flush
@@ -381,7 +390,7 @@ module Clacky
       def write_output_line(line)
         # Add to buffer for potential re-rendering
         @output_buffer << line
-        
+
         # Calculate where fixed area starts (this is where output area ends)
         max_output_row = fixed_area_start_row
 
@@ -581,21 +590,21 @@ module Clacky
       # @param hint [String] Hint message at bottom
       def enter_fullscreen(lines, hint: "Press Ctrl+O to return")
         return if @fullscreen_mode
-        
+
         @fullscreen_mode = true
-        
+
         # Enter alternate screen buffer
         print "\e[?1049h"
         # Clear screen and move cursor to top
         print "\e[2J\e[H"
         $stdout.flush
-        
+
         # Show all lines with proper line endings (CR+LF)
         lines.each do |line|
           # Strip trailing newline and print with CR+LF
           print line.chomp + "\r\n"
         end
-        
+
         # Show hint at bottom
         print "\r\n"
         print "\e[36m#{hint}\e[0m\r\n"
@@ -605,9 +614,9 @@ module Clacky
       # Exit fullscreen mode and restore previous screen
       def exit_fullscreen
         return unless @fullscreen_mode
-        
+
         @fullscreen_mode = false
-        
+
         # Exit alternate screen buffer (automatically restores previous screen)
         print "\e[?1049l"
         $stdout.flush
@@ -628,7 +637,7 @@ module Clacky
       # Check and process pending resize (should be called from main thread periodically)
       def process_pending_resize
         return unless @resize_pending
-        
+
         @resize_pending = false
         handle_resize_safely
       end

data/lib/clacky/ui2/screen_buffer.rb

@@ -24,9 +24,21 @@ module Clacky
         print "\e[#{row + 1};#{col + 1}H"
       end
 
-      # Clear entire screen
-      def clear_screen
-        print "\e[2J"
+      # Clear screen with different modes:
+      #   :preserve - clear visible screen, scrollback history preserved (default)
+      #   :current  - cursor to top-left and erase to end, no new scrollback produced
+      #   :reset    - clear visible screen AND scrollback history (full reset)
+      # @param mode [Symbol] Clear mode (:preserve, :current, :reset)
+      def clear_screen(mode: :preserve)
+        case mode
+        when :reset
+          print "\e[3J"    # erase scrollback buffer
+          print "\e[H\e[J" # cursor to top-left, erase to end of screen
+        when :current
+          print "\e[H\e[J" # cursor to top-left, erase to end of screen
+        else # :preserve
+          print "\e[2J\e[H"    # erase visible screen, scrollback preserved
+        end
         move_cursor(0, 0)
       end
 
@@ -118,7 +130,7 @@ module Clacky
         if timeout
           return nil unless IO.select([$stdin], nil, nil, timeout)
         end
-        
+
         $stdin.getc
       end
 
@@ -172,11 +184,11 @@ module Clacky
           # Keep reading available characters
           loop_count = 0
           empty_checks = 0
-          
+
           loop do
             # Check if there's data available immediately
             has_data = IO.select([$stdin], nil, nil, 0)
-            
+
             if has_data
               next_char = $stdin.getc
               break unless next_char

data/lib/clacky/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Clacky
-  VERSION = "0.7.4"
+  VERSION = "0.7.5"
 end

data/scripts/install.sh

@@ -398,14 +398,6 @@ show_post_install_info() {
     echo "║                                                           ║"
     echo "╚═══════════════════════════════════════════════════════════╝"
     echo ""
-    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-    echo ""
-    echo "  ⚠️  ${YELLOW}IMPORTANT: Please restart your terminal${NC}"
-    echo ""
-    echo "  After restarting, type: ${GREEN}openclacky${NC}"
-    echo ""
-    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-    echo ""
     print_step "Quick Start Guide:"
     echo ""
     print_info "1. Configure your API key:"
@@ -420,6 +412,14 @@ show_post_install_info() {
     echo ""
     print_success "Happy coding! 🚀"
     echo ""
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+    echo -e "  ⚠️  ${YELLOW}IMPORTANT: Please restart your terminal${NC}"
+    echo ""
+    echo -e "  After restarting, type: ${GREEN}openclacky${NC}"
+    echo ""
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
 }
 
 # Run main installation

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: openclacky
 version: !ruby/object:Gem::Version
-  version: 0.7.4
+  version: 0.7.5
 platform: ruby
 authors:
 - windy