openclacky 0.6.1 → 0.6.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9c052d03a1c67251ddb1310bd82b4d1bbee0129716f4e0f2ec664dfdf3b52ced
-  data.tar.gz: 1d04af0f03f0e03e5ef41a312b2074a8b53a57d2fc9b38f95e73fe3baed3ffd4
+  metadata.gz: 84e359dab8c2113e7b9160f92eadff62872bce2a1c1713abee9a2cbf4cac80b1
+  data.tar.gz: 604a48aaa45cf5bc79667e9fbd0792626aa578b65d7d0a8b06c5548759d3de39
 SHA512:
-  metadata.gz: 6a78384406082c30a41e3546b145230276532567664e2fcf2d6de579a7765966d9ce837629c24b1e35e27f5b9a60b7e1337d6f95981665f74cc99cdee52773ef
-  data.tar.gz: 6da58385006861fcb511c56febf1a0c81d5f30825354e3610201ea2b4c53a29f0d65fd41cf89447c9347c396de4dadb77f7139e4a69d19d0f5debcc986e5536f
+  metadata.gz: 8c037ed1835e6295338b3136795d8be58ad3ae3654d6174c85cc7b05e237094fa8a39c96ec26c16106c6ff2ef382f7e5c88aca8b01da7e0b891ec438c579fd17
+  data.tar.gz: ebdd5c9a65cd21fdc7fb47743f3c6b9b5ce9fd0552fabb1a0a1c02554da8c91b9464718e1fd01f5dc18593740c22377ca67e132fd5c4ab67183166a878b039b7

data/CHANGELOG.md

@@ -7,6 +7,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.2] - 2026-01-30
+
+### Added
+- `--theme` CLI option to switch UI themes (hacker, minimal)
+- Support for reading binary files (with 5MB limit)
+- Cost color coding for better visibility
+- Install script for easier installation
+- New command handling improvements
+
+### Improved
+- User input style enhancements
+- Tool execution output simplification
+- Thinking mode output improvements
+- Diff format display with cleaner line numbers
+- Terminal resize handling
+
+### Fixed
+- BadQuotedString parsing error
+- Token counting for every new task
+- Shell output max characters limit
+- Inline input cursor positioning
+- Compress message display (now hidden)
+
+### Removed
+- Redundant output components for cleaner architecture
+
 ## [0.6.1] - 2026-01-29
 
 ### Added

data/README.md

@@ -18,19 +18,36 @@ OpenClacky = Lovable + Supabase
 
 ## Installation
 
-Install the gem by executing:
+### Quick Install (Recommended)
+
+**One-line installation** (auto-detects your system):
 
 ```bash
-gem install openclacky
+curl -sSL https://raw.githubusercontent.com/clacky-ai/open-clacky/main/scripts/install.sh | bash
 ```
 
-Or add it to your Gemfile:
+This script will:
+- Check your Ruby version
+- Install via Homebrew (macOS) if available
+- Install via RubyGems if Ruby >= 3.1.0 is installed
+- Guide you to install Ruby if needed
+
+### Method 1: Homebrew (macOS/Linux)
+
+**Best for macOS users** - Automatically handles Ruby dependencies:
 
 ```bash
-bundle add openclacky
+brew tap clacky-ai/openclacky
+brew install openclacky
 ```
 
-For development from source:
+### Method 2: RubyGems (If you already have Ruby >= 3.1.0)
+
+```bash
+gem install openclacky
+```
+
+### Method 3: From Source (For Development)
 
 ```bash
 git clone https://github.com/clacky-ai/open-clacky.git
@@ -39,6 +56,22 @@ bundle install
 bin/clacky
 ```
 
+### System Requirements
+
+- **Ruby**: >= 3.1.0 (automatically handled by Homebrew)
+- **OS**: macOS, Linux, or Windows (WSL)
+
+### Uninstallation
+
+```bash
+# Quick uninstall
+curl -sSL https://raw.githubusercontent.com/clacky-ai/open-clacky/main/scripts/uninstall.sh | bash
+
+# Or manually
+brew uninstall openclacky  # If installed via Homebrew
+gem uninstall openclacky   # If installed via gem
+```
+
 ## Configuration
 
 Before using Clacky, you need to configure your settings:
@@ -60,32 +93,6 @@ clacky config show
 
 ## Usage
 
-### Interactive Chat Mode
-
-Start an interactive chat session:
-
-```bash
-clacky chat
-```
-
-Type your messages and press Enter. Type `exit` or `quit` to end the session.
-
-### Single Message Mode
-
-Send a single message and get a response:
-
-```bash
-clacky chat "What is Ruby?"
-```
-
-### Specify Model
-
-You can specify which model to use (overrides config):
-
-```bash
-clacky chat --model=gpt-4 "Hello!"
-```
-
 ### AI Agent Mode (Interactive)
 
 Run an autonomous AI agent in interactive mode. The agent can use tools to complete tasks and runs in a continuous loop, allowing you to have multi-turn conversations with tool use capabilities.
@@ -103,22 +110,10 @@ clacky agent --mode=auto_approve
 # Work in a specific project directory
 clacky agent --path /path/to/project
 
-# Limit tools available to the agent
-clacky agent --tools file_reader glob grep
-```
-
-The agent will:
-1. Complete each task using its React (Reason-Act-Observe) cycle
-2. Show you the results
-3. Wait for your next instruction
-4. Maintain conversation context across tasks
-5. Type 'exit' or 'quit' to end the session
-
 #### Permission Modes
 
-- `confirm_all` (default) - Confirm every tool use
-- `confirm_edits` - Auto-approve read-only tools, confirm edits
 - `auto_approve` - Automatically execute all tools (use with caution)
+- `confirm_safes` - Auto-approve read-only tools, confirm edits
 - `plan_only` - Generate plan without executing
 
 #### Agent Options
@@ -126,9 +121,6 @@ The agent will:
 ```bash
 --path PATH                    # Project directory (defaults to current directory)
 --mode MODE                    # Permission mode
---tools TOOL1 TOOL2            # Allowed tools (or "all")
---max-iterations N             # Maximum iterations (default: 50)
---max-cost N                   # Maximum cost in USD (default: 5.0)
 --verbose                      # Show detailed output
 ```
 
@@ -138,30 +130,17 @@ The agent includes intelligent cost control features:
 
 - **Automatic Message Compression**: When conversation history grows beyond 100 messages, the agent automatically compresses older messages into a summary, keeping only the system prompt and the most recent 20 messages. This dramatically reduces token costs for long-running tasks (achieves ~60% compression ratio).
 
-- **Configurable Limits**:
-  - `max_iterations`: Maximum number of agent loops (default: 200)
-  - `max_cost_usd`: Maximum total cost in USD (default: $5.00)
-  - `timeout_seconds`: Maximum execution time (default: none)
-
 - **Compression Settings**:
   - `enable_compression`: Enable/disable automatic compression (default: true)
   - `keep_recent_messages`: Number of recent messages to preserve (default: 20)
   - Compression triggers at: ~100 messages (keep_recent_messages + 80)
 
-Example with custom limits:
-```bash
-clacky agent --max-iterations=100 --max-cost=10.0 --verbose
-```
-
 ### List Available Tools
 
 View all built-in tools:
 
 ```bash
 clacky tools
-
-# Filter by category
-clacky tools --category file_system
 ```
 
 #### Built-in Tools
@@ -173,14 +152,12 @@ clacky tools --category file_system
 - **glob** - Find files by pattern matching
 - **grep** - Search file contents with regex
 - **shell** - Execute shell commands
-- **calculator** - Perform mathematical calculations
 - **web_search** - Search the web for information
 - **web_fetch** - Fetch and parse web page content
 
 ### Available Commands
 
 ```bash
-clacky chat [MESSAGE]     # Start a chat or send a single message
 clacky agent [MESSAGE]    # Run autonomous agent with tool use
 clacky tools              # List available tools
 clacky config set         # Set your API key
@@ -191,19 +168,6 @@ clacky help               # Show help information
 
 ## Examples
 
-### Chat Examples
-
-```bash
-# Quick question
-clacky chat "Explain closures in Ruby"
-
-# Start interactive session
-clacky chat
-
-# Check version
-clacky version
-```
-
 ### Agent Examples
 
 ```bash
@@ -214,25 +178,12 @@ clacky agent
 # > Now add more items to the TODO list
 # > exit
 
-# Start with initial task, then continue
-clacky agent "Add a .gitignore file for Ruby projects"
-# After completing, agent waits for next task
-# > List all Ruby files
-# > Count lines in each file
-# > exit
-
 # Auto-approve mode for trusted operations
 clacky agent --mode=auto_approve --path ~/my-project
 # > Count all lines of code
 # > Create a summary report
 # > exit
 
-# Use specific tools only in interactive mode
-clacky agent --tools file_reader glob grep
-# > Find all TODO comments
-# > Search for FIXME comments
-# > exit
-
 # Using TODO manager for complex tasks
 clacky agent "Implement a new feature with user authentication"
 # Agent will:

data/homebrew/README.md

@@ -0,0 +1,96 @@
+# Homebrew Formula for OpenClacky
+
+This directory contains the Homebrew formula for OpenClacky.
+
+## For Maintainers: Publishing to Homebrew Tap
+
+### One-time Setup
+
+1. Create a GitHub repository named `homebrew-openclacky` (must start with `homebrew-`)
+2. Push this formula to the repository
+
+```bash
+# In your GitHub account, create: homebrew-openclacky
+git clone https://github.com/YOUR_USERNAME/homebrew-openclacky.git
+cd homebrew-openclacky
+cp /path/to/openclacky/homebrew/openclacky.rb ./Formula/openclacky.rb
+git add Formula/openclacky.rb
+git commit -m "Add openclacky formula"
+git push origin main
+```
+
+### Update Formula for New Release
+
+When you release a new version:
+
+1. Download the new gem and calculate SHA256:
+```bash
+VERSION=0.6.1
+wget https://rubygems.org/downloads/openclacky-${VERSION}.gem
+shasum -a 256 openclacky-${VERSION}.gem
+```
+
+2. Update the formula in `homebrew-openclacky` repository:
+- Update `url` with new version
+- Update `sha256` with calculated hash
+- Commit and push
+
+3. Users can then upgrade:
+```bash
+brew update
+brew upgrade openclacky
+```
+
+## For Users: Installation
+
+```bash
+# Add the tap (one-time)
+brew tap YOUR_USERNAME/openclacky
+
+# Install
+brew install openclacky
+
+# Or in one command
+brew install YOUR_USERNAME/openclacky/openclacky
+```
+
+## Testing the Formula Locally
+
+```bash
+# Install from local formula
+brew install --build-from-source ./homebrew/openclacky.rb
+
+# Or test without installing
+brew test ./homebrew/openclacky.rb
+```
+
+## Automation Script
+
+For easier updates, use this script:
+
+```bash
+#!/bin/bash
+# update_formula.sh
+
+VERSION=$1
+if [ -z "$VERSION" ]; then
+  echo "Usage: ./update_formula.sh VERSION"
+  exit 1
+fi
+
+# Download gem
+wget https://rubygems.org/downloads/openclacky-${VERSION}.gem -O /tmp/openclacky.gem
+
+# Calculate SHA256
+SHA256=$(shasum -a 256 /tmp/openclacky.gem | cut -d' ' -f1)
+
+# Update formula
+sed -i '' "s|url \".*\"|url \"https://rubygems.org/downloads/openclacky-${VERSION}.gem\"|" openclacky.rb
+sed -i '' "s|sha256 \".*\"|sha256 \"${SHA256}\"|" openclacky.rb
+
+echo "Formula updated to version ${VERSION}"
+echo "SHA256: ${SHA256}"
+echo "Don't forget to commit and push to homebrew-openclacky repository!"
+
+rm /tmp/openclacky.gem
+```

data/homebrew/openclacky.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+class Openclacky < Formula
+  desc "Command-line interface for AI models with autonomous agent capabilities"
+  homepage "https://github.com/clacky-ai/open-clacky"
+  url "https://rubygems.org/downloads/openclacky-0.6.1.gem"
+  sha256 "" # Will be updated when gem is published
+  license "MIT"
+
+  depends_on "ruby@3.3"
+
+  def install
+    ENV["GEM_HOME"] = libexec
+    system "gem", "install", cached_download, "--no-document"
+    
+    # Create wrapper scripts
+    (bin/"openclacky").write_env_script libexec/"bin/openclacky", GEM_HOME: ENV["GEM_HOME"]
+    (bin/"clacky").write_env_script libexec/"bin/clacky", GEM_HOME: ENV["GEM_HOME"]
+  end
+
+  test do
+    assert_match "openclacky version #{version}", shell_output("#{bin}/openclacky version")
+  end
+end

data/lib/clacky/agent.rb

@@ -4,8 +4,8 @@ require "securerandom"
 require "json"
 require "tty-prompt"
 require "set"
-require "base64"
 require_relative "utils/arguments_parser"
+require_relative "utils/file_processor"
 
 module Clacky
   class Agent
@@ -137,7 +137,7 @@ module Clacky
       user_messages = @messages.select do |m|
         m[:role] == "user" && !m[:system_injected]
       end
-      
+
       # Extract text content from the last N user messages
       user_messages.last(limit).map do |msg|
         extract_text_from_content(msg[:content])
@@ -163,10 +163,11 @@ module Clacky
     def run(user_input, images: [])
       @start_time = Time.now
       @task_cost_source = :estimated  # Reset for new task
-      @previous_total_tokens = 0  # Reset token tracking for new task
+      # Note: Do NOT reset @previous_total_tokens here - it should maintain the value from the last iteration
+      # across tasks to correctly calculate delta tokens in each iteration
       @task_start_iterations = @iterations  # Track starting iterations for this task
       @task_start_cost = @total_cost  # Track starting cost for this task
-      
+
       # Track cache stats for current task
       @task_cache_stats = {
         cache_creation_input_tokens: 0,
@@ -538,7 +539,7 @@ module Clacky
               denial_message += ": #{confirmation[:feedback]}"
             end
             @ui&.show_warning(denial_message)
-            
+
             denied = true
             user_feedback = confirmation[:feedback]
             feedback = user_feedback if user_feedback
@@ -666,7 +667,7 @@ module Clacky
         # Check if the command is a slow command
         command = args[:command] || args['command']
         return false unless command
-        
+
         # List of slow command patterns
         slow_patterns = [
           /bundle\s+(install|exec\s+rspec|exec\s+rake)/,
@@ -679,7 +680,7 @@ module Clacky
           /pytest/,
           /jest/
         ]
-        
+
         slow_patterns.any? { |pattern| command.match?(pattern) }
       when 'web_fetch', 'web_search'
         true  # Network operations can be slow
@@ -692,11 +693,7 @@ module Clacky
     private def build_tool_progress_message(tool_name, args)
       case tool_name.to_s.downcase
       when 'shell', 'safe_shell'
-        command = args[:command] || args['command']
-        # Extract the main command for display
-        cmd_parts = command.to_s.split
-        main_cmd = cmd_parts.first(2).join(' ')
-        "Running #{main_cmd}"
+        "Running command"
       when 'web_fetch'
         "Fetching web page"
       when 'web_search'
@@ -755,15 +752,15 @@ module Clacky
         @cache_stats[:raw_api_usage_samples] << raw_api_usage
         @cache_stats[:raw_api_usage_samples] = @cache_stats[:raw_api_usage_samples].last(3)
       end
-      
+
       # Track cache usage for current task
       if @task_cache_stats
         @task_cache_stats[:total_requests] += 1
-        
+
         if usage[:cache_creation_input_tokens]
           @task_cache_stats[:cache_creation_input_tokens] += usage[:cache_creation_input_tokens]
         end
-        
+
         if usage[:cache_read_input_tokens]
           @task_cache_stats[:cache_read_input_tokens] += usage[:cache_read_input_tokens]
           @task_cache_stats[:cache_hit_requests] += 1
@@ -957,7 +954,8 @@ module Clacky
 
       {
         role: "user",
-        content: "[SYSTEM] " + summary_text
+        content: "[SYSTEM] " + summary_text,
+        system_injected: true
       }
     end
 
@@ -1200,10 +1198,10 @@ module Clacky
     def build_result(status, error: nil)
       # Calculate iterations for current task only
       task_iterations = @iterations - (@task_start_iterations || 0)
-      
+
       # Calculate cost for current task only
       task_cost = @total_cost - (@task_start_cost || 0)
-      
+
       {
         status: status,
         session_id: @session_id,
@@ -1257,64 +1255,13 @@ module Clacky
       content << { type: "text", text: text } unless text.nil? || text.empty?
 
       images.each do |image_path|
-        image_url = image_path_to_data_url(image_path)
+        image_url = Utils::FileProcessor.image_path_to_data_url(image_path)
         content << { type: "image_url", image_url: { url: image_url } }
       end
 
       content
     end
 
-    # Convert image file path to base64 data URL
-    # @param path [String] File path to image
-    # @return [String] base64 data URL (e.g., "data:image/png;base64,...")
-    def image_path_to_data_url(path)
-      unless File.exist?(path)
-        raise ArgumentError, "Image file not found: #{path}"
-      end
-
-      # Read file as binary
-      image_data = File.binread(path)
-
-      # Detect MIME type from file extension or content
-      mime_type = detect_image_mime_type(path, image_data)
-
-      # Encode to base64
-      base64_data = Base64.strict_encode64(image_data)
-
-      "data:#{mime_type};base64,#{base64_data}"
-    end
 
-    # Detect image MIME type
-    # @param path [String] File path
-    # @param data [String] Binary image data
-    # @return [String] MIME type (e.g., "image/png")
-    def detect_image_mime_type(path, data)
-      # Try to detect from file extension first
-      ext = File.extname(path).downcase
-      case ext
-      when ".png"
-        "image/png"
-      when ".jpg", ".jpeg"
-        "image/jpeg"
-      when ".gif"
-        "image/gif"
-      when ".webp"
-        "image/webp"
-      else
-        # Try to detect from file signature (magic bytes)
-        if data.start_with?("\x89PNG".b)
-          "image/png"
-        elsif data.start_with?("\xFF\xD8\xFF".b)
-          "image/jpeg"
-        elsif data.start_with?("GIF87a".b) || data.start_with?("GIF89a".b)
-          "image/gif"
-        elsif data.start_with?("RIFF".b) && data[8..11] == "WEBP".b
-          "image/webp"
-        else
-          # Default to png if unknown
-          "image/png"
-        end
-      end
-    end
   end
 end

data/lib/clacky/cli.rb

@@ -32,6 +32,10 @@ module Clacky
         confirm_edits   - Auto-approve read-only tools, confirm edits
         plan_only       - Generate plan without executing
 
+      UI themes:
+        hacker          - Matrix/hacker-style with bracket symbols (default)
+        minimal         - Clean, simple symbols
+
       Session management:
         -c, --continue  - Continue the most recent session for this directory
         -l, --list      - List recent sessions
@@ -42,6 +46,8 @@ module Clacky
     LONGDESC
     option :mode, type: :string, default: "confirm_safes",
            desc: "Permission mode: auto_approve, confirm_safes, confirm_edits, plan_only"
+    option :theme, type: :string, default: "hacker",
+           desc: "UI theme: hacker, minimal (default: hacker)"
     option :verbose, type: :boolean, aliases: "-v", default: false, desc: "Show detailed output"
     option :path, type: :string, desc: "Project directory path (defaults to current directory)"
     option :continue, type: :boolean, aliases: "-c", desc: "Continue most recent session"
@@ -127,6 +133,80 @@ module Clacky
       end
     end
 
+    desc "new PROJECT_NAME", "Create a new Rails project from the official template"
+    long_desc <<-LONGDESC
+      Create a new Rails project from the official template.
+
+      This command will:
+        1. Clone the template from git@github.com:clacky-ai/rails-template-7x-starter.git
+        2. Change into the project directory
+        3. Run bin/setup to install dependencies and configure the project
+
+      Example:
+        $ clacky new my_rails_app
+    LONGDESC
+    def new(project_name = nil)
+      unless project_name
+        say "Error: Project name is required.", :red
+        say "Usage: clacky new <project_name>", :yellow
+        exit 1
+      end
+
+      # Validate project name
+      unless project_name.match?(/^[a-zA-Z][a-zA-Z0-9_-]*$/)
+        say "Error: Invalid project name. Use only letters, numbers, underscores, and hyphens.", :red
+        exit 1
+      end
+
+      template_repo = "git@github.com:clacky-ai/rails-template-7x-starter.git"
+      current_dir = Dir.pwd
+      target_dir = File.join(current_dir, project_name)
+
+      # Check if target directory already exists
+      if Dir.exist?(target_dir)
+        say "Error: Directory '#{project_name}' already exists.", :red
+        exit 1
+      end
+
+      say "Creating new Rails project: #{project_name}", :green
+
+      # Clone the template repository
+      say "\n📦 Cloning template repository...", :cyan
+      clone_command = "git clone #{template_repo} #{project_name}"
+
+      clone_result = system(clone_command)
+
+      unless clone_result
+        say "\n❌ Failed to clone repository. Please check your git configuration and network connection.", :red
+        exit 1
+      end
+
+      say "✓ Repository cloned successfully", :green
+
+      # Run bin/setup
+      say "\n⚙️  Running bin/setup...", :cyan
+
+      Dir.chdir(target_dir)
+
+      setup_command = "./bin/setup"
+
+      setup_result = system(setup_command)
+
+      Dir.chdir(current_dir)
+
+      unless setup_result
+        say "\n❌ Failed to run bin/setup. Please check the setup script for errors.", :red
+        say "You can try running it manually:", :yellow
+        say "  cd #{project_name} && ./bin/setup", :cyan
+        exit 1
+      end
+
+      say "\n✅ Project '#{project_name}' created successfully!", :green
+      say "\nNext steps:", :green
+      say "  cd #{project_name}", :cyan
+      say "  clacky agent", :cyan
+    end
+
     desc "price", "Show pricing information for AI models"
     def price
       say "\n💰 Model Pricing Information\n\n", :green
@@ -300,11 +380,20 @@ module Clacky
 
       # Run agent with UI2 split-screen interface
       def run_agent_with_ui2(agent, working_dir, agent_config, initial_message = nil, session_manager = nil, client = nil, is_session_load: false)
+        # Validate theme
+        theme_name = options[:theme] || "hacker"
+        available_themes = UI2::ThemeManager.available_themes.map(&:to_s)
+        unless available_themes.include?(theme_name)
+          say "Error: Unknown theme '#{theme_name}'. Available themes: #{available_themes.join(', ')}", :red
+          exit 1
+        end
+
         # Create UI2 controller with configuration
         ui_controller = UI2::UIController.new(
           working_dir: working_dir,
           mode: agent_config.permission_mode.to_s,
-          model: agent_config.model
+          model: agent_config.model,
+          theme: theme_name
         )
 
         # Inject UI into agent