openclacky 0.6.3 → 0.6.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3a21b23940f55985b4d58e1ff4cc1f3f6b71a14a8035ae88cc9d5721248e91e9
-  data.tar.gz: 42e4c3b910bdeb242ea9dd5e5d690b49612fadc1d59b3921facca593b7fa6bc0
+  metadata.gz: dcf90e79799d6f487ba77c084b9b3b72fc7c5252e2ffc7a3e56a0973bb9df977
+  data.tar.gz: 52a2e19427036920d29ee27c5021f731cfc924fc9c6800e22040a017f74c7fc7
 SHA512:
-  metadata.gz: 823af49c74737e48affb60d4292787042470edf76b9566debd419177974379e18afa8611a1d00fdd3082a2d7863c8b6bc56f43ce887a7493d86600b9f8a6270d
-  data.tar.gz: 44cbdfac975198bd766987e452415fd5b6758001501816f13c5bbb46a2206c34f52c61d1781a0ad8a40813c23add2291d2bc2e4a330733a76385b27452033fe6
+  metadata.gz: 90180817198ad434c4920c855e92215fafe0495f11b93cdf156e1a1a13239219bf3d68f061900265165cf897d601f6913a8815e5c22e60d341cdb3ea6b661bde
+  data.tar.gz: e09ba63257284794970bd5929d1e310465120e98fe5330be371cd5a00935976f1e537843b7d05e7532400f757564a8be860b3621125f665fecb30eb81ff76199

data/CHANGELOG.md

@@ -7,6 +7,36 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.3] - 2026-02-01
+
+### Added
+- Complete skill system with loader and core functionality
+- Default skill support with auto-loading mechanism
+- Skills CLI command for skill management (`clacky skills list/show/create`)
+- Command suggestions UI component for better user guidance
+- Skip safety check option for safe_shell tool
+- UI2 component comprehensive test suite
+- Token output control for file_reader and shell tools
+- Grep max files limit configuration
+- File_reader tool index support
+- Web fetch content length limiting
+
+### Improved
+- File_reader line range handling logic
+- Message compression strategy (100 message compress)
+- Inline input wrap line handling
+- Cursor position calculation for multi-line inline input
+- Theme adjustments for better visual experience
+- Skill system integration with agent
+- Gem-release skill metadata standardization
+- Skill documentation with user experience summaries
+
+### Fixed
+- Skill commands now properly pass through to agent
+- Session restore data loading with -a or -c flags
+- Inline input cursor positioning for wrapped lines
+- Multi-line inline input cursor calculation
+
 ## [0.6.2] - 2026-01-30
 
 ### Added

data/docs/why-openclacky.md

@@ -0,0 +1,267 @@
+# Why OpenClacky?
+
+## The Vision: AI-Powered Development for Everyone
+
+**Clacky** is an open-source, CLI-first AI development assistant designed to make software creation accessible to non-technical users while remaining powerful enough for professional developers.
+
+Our ultimate vision: **OpenClacky = Lovable + Supabase** — an open-source alternative that combines the ease-of-use of no-code platforms with the flexibility of a modern Rails application.
+
+---
+
+## The Problem
+
+Building software today is still too hard for most people:
+
+| Challenge | Current Solutions |
+|-----------|-------------------|
+| **Too technical** | Requires learning programming, DevOps, deployment |
+| **Too expensive** | Enterprise tools cost $100+/month |
+| **Too locked-in** | Vendor lock-in with proprietary platforms |
+| **Too complex** | Modern tech stacks have steep learning curves |
+
+Non-technical founders, designers, and product managers often have great ideas but can't build them. Existing AI tools either:
+- **Are too technical** (Claude Code, GitHub Copilot)
+- **Are too expensive** (Lovable $25+/month)
+- **Lock you into proprietary platforms** (v0, Lovable)
+
+---
+
+## The Solution: Clacky
+
+Clacky bridges the gap between no-code simplicity and developer-grade power.
+
+### Our Two-Part Strategy
+
+#### Part 1: CLI for Everyone (Current Focus)
+
+A command-line AI assistant that's approachable for non-technical users but powerful enough to rival Claude Code.
+
+**Key Differentiators:**
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                     Clacky CLI Features                      │
+├─────────────────────────────────────────────────────────────┤
+│ ✅ confirm_safes mode     │ More automation than Claude     │
+│ ✅ Real-time cost monitor │ See token usage in real-time    │
+│ ✅ Session persistence    │ Pause & resume your work        │
+│ ✅ SafeShell protection   │ Commands made safe automatically│
+│ ✅ Multi-API support      │ DeepSeek, OpenRouter, OpenAI    │
+│ ✅ Skills system          │ Extensible command shortcuts    │
+│ ✅ Open source            │ MIT License - no vendor lock-in │
+│ ✅ $0 monthly cost        │ Pay only for API usage          │
+└─────────────────────────────────────────────────────────────┘
+```
+
+**Why Non-Technical Users Love Clacky:**
+
+1. **Natural Language Commands**
+   ```
+   clacky agent "Create a REST API for user management"
+   clacky agent "Add authentication to my Rails app"
+   ```
+
+2. **Safe by Default**
+   - Dangerous commands (`rm`, `curl | sh`) are automatically made safe
+   - Files moved to trash instead of deleted
+   - Project boundaries enforced
+
+3. **Transparent Costs**
+   ```
+   💰 Cost: $0.0042 (Claude 3.5 Sonnet)
+   📊 Tokens: 1,250 in / 850 out
+   🗜️  Compression saved: 60%
+   ```
+
+4. **Permission Modes for Every Situation**
+
+   | Mode | Behavior | Best For |
+   |------|----------|----------|
+   | `auto_approve` | Execute all tools automatically | Batch operations |
+   | `confirm_safes` | Auto-approve safe operations | Daily development |
+   | `confirm_edits` | Confirm file modifications | Careful work |
+   | `plan_only` | Generate plans only | Code review |
+
+5. **Session Recovery**
+   ```bash
+   clacky agent -c              # Continue last session
+   clacky agent -l              # List recent sessions
+   clacky agent -a 2            # Attach to specific session
+   ```
+
+#### Part 2: AI-Ready Rails Template (Coming Soon)
+
+```
+clacky new my_project
+```
+
+A production-ready Rails application scaffold designed specifically for AI-powered development, including:
+
+| Feature | Description |
+|---------|-------------|
+| 🔐 **Authentication** | Built-in login/registration with Devise |
+| 🤖 **LLM Integration** | Pre-configured for Claude, OpenAI, DeepSeek |
+| ⚡ **Async Jobs** | Sidekiq for background processing |
+| 🔄 **WebSockets** | Action Cable for real-time features |
+| 🎨 **Beautiful UI** | Tailwind CSS + Hotwire components |
+| 📊 **Admin Dashboard** | ActiveAdmin or Avo integration |
+| 🚀 **One-Click Deploy** | Docker + Kamal/Cloud66 ready |
+
+**Why Rails?**
+
+- Mature, stable, and well-documented
+- Great for AI apps (LLM calls, async processing, web interface)
+- Strong conventions reduce decision fatigue
+- ActiveJob, Action Cable, Hotwire built-in
+
+---
+
+## Clacky vs. The Competition
+
+| Feature | **Clacky** | Claude Code | Lovable | Cursor |
+|---------|------------|-------------|---------|--------|
+| **Target Users** | Non-technical + Devs | Developers only | Non-technical | Developers |
+| **Interface** | CLI | CLI + IDE + Web | Web only | IDE |
+| **Open Source** | ✅ MIT | ❌ Closed | ❌ Closed | ❌ Closed |
+| **Monthly Cost** | $0 (API only) | $17-200 | $25-99+ | $20+ |
+| **Self-Hosted** | ✅ Yes | ❌ No | ❌ No | ❌ No |
+| **Multi-API** | ✅ DeepSeek, OpenRouter | ❌ Anthropic only | ❌ Limited | ❌ OpenAI only |
+| **SafeShell** | ✅ Auto-protection | ⚠️ Manual | N/A | ⚠️ Manual |
+| **Sessions** | ✅ Persistent | ⚠️ Limited | ⚠️ Limited | ⚠️ Limited |
+| **Skills/Plugins** | ✅ Extensible | ❌ No | ❌ No | ⚠️ Limited |
+| **Rails Template** | ✅ Coming soon | ❌ No | ⚠️ Limited | ❌ No |
+
+---
+
+## Why Now?
+
+### The AI Development Revolution
+
+We're at a unique moment in software history:
+
+1. **AI models are now capable** of generating production-quality code
+2. **APIs are affordable** - DeepSeek is 95% cheaper than OpenAI
+3. **CLI is experiencing a renaissance** - Developers prefer terminal tools
+4. **Open source AI is viable** - No vendor lock-in
+
+### The Open Source Advantage
+
+Unlike proprietary platforms, Clacky gives you:
+
+- **Freedom**: Use any model, any API, any provider
+- **Control**: Self-host everything, no data leaves your machine
+- **Customization**: Modify the source code for your needs
+- **Community**: Learn from others, contribute back
+- **Longevity**: No risk of the platform shutting down
+
+---
+
+## Our Roadmap
+
+### Phase 1: CLI Excellence (Current)
+- [x] Core agent with tool execution
+- [x] confirm_safes mode (more automation)
+- [x] Real-time cost monitoring
+- [x] SafeShell protection
+- [x] Session persistence
+- [x] Skills system
+
+### Phase 2: Rails Template (Coming Soon)
+- [ ] `clacky new` command
+- [ ] Pre-configured authentication
+- [ ] LLM integration ready
+- [ ] Async job system
+- [ ] WebSocket support
+- [ ] Admin dashboard
+- [ ] Docker + deployment configs
+
+### Phase 3: The Lovable Alternative
+- [ ] Web-based project manager
+- [ ] Visual component library
+- [ ] Database schema designer
+- [ ] One-click deployment
+
+---
+
+## Pricing Philosophy
+
+We believe AI development tools should be accessible to everyone.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│                    Clacky Pricing                          │
+├────────────────────────────────────────────────────────────┤
+│ 📦 Clacky CLI           │ $0/month (Open Source)           │
+│    • All features       │ Pay only for API usage           │
+│    • No subscription    │ Use DeepSeek, OpenRouter, etc.   │
+│                        │                                  │
+│ 🚀 Rails Template      │ $0 (Open Source)                 │
+│    • Full source code   │ MIT License                      │
+│    • Self-host          │ No vendor lock-in                │
+│                        │                                  │
+│ 💎 Enterprise Support  │ Contact us                        │
+│    • Custom development│ Training & consulting            │
+└────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Get Started
+
+### Quick Install
+
+```bash
+# One-line installation (macOS/Linux)
+curl -sSL https://raw.githubusercontent.com/clacky-ai/open-clacky/main/scripts/install.sh | bash
+
+# Or if you have Ruby 3.1+
+gem install openclacky
+```
+
+### First Steps
+
+```bash
+# Configure your API key
+clacky config set
+
+# Start the agent
+clacky agent
+
+# Or give it a task
+clacky agent "Create a TODO list app"
+
+# See all tools
+clacky tools
+```
+
+---
+
+## Join Us
+
+Clacky is an open-source project. We welcome contributions!
+
+- **GitHub**: https://github.com/clacky-ai/open-clacky
+- **Discord**: https://discord.gg/clacky
+- **Twitter**: https://twitter.com/clacky_ai
+
+---
+
+## Summary
+
+**Clacky** is for anyone who wants to build software but has been held back by technical complexity or expensive tools.
+
+Whether you're a:
+- 🎨 **Designer** who wants to prototype ideas
+- 💼 **Product Manager** who wants to validate concepts
+- 🚀 **Founder** who wants to build an MVP
+- 👨‍💻 **Developer** who wants a more automated CLI
+
+...Clacky is here to help.
+
+**The future of software development is accessible, open, and AI-powered.**
+
+**Welcome to Clacky.**
+
+---
+
+*Last updated: February 2025*

data/lib/clacky/agent.rb

@@ -226,6 +226,17 @@ module Clacky
           # Check if done (no more tool calls needed)
           if response[:finish_reason] == "stop" || response[:tool_calls].nil? || response[:tool_calls].empty?
             @ui&.show_assistant_message(response[:content]) if response[:content] && !response[:content].empty?
+
+            # Debug: log why we're stopping
+            if @config.verbose && (response[:tool_calls].nil? || response[:tool_calls].empty?)
+              reason = response[:finish_reason] == "stop" ? "API returned finish_reason=stop" : "No tool calls in response"
+              @ui&.log("Stopping: #{reason}", level: :debug)
+              if response[:content] && response[:content].is_a?(String)
+                preview = response[:content].length > 200 ? response[:content][0...200] + "..." : response[:content]
+                @ui&.log("Response content: #{preview}", level: :debug)
+              end
+            end
+
             break
           end
 
@@ -526,7 +537,7 @@ module Clacky
       @ui&.show_progress
 
       # Compress messages if needed to reduce cost
-      compress_messages_if_needed
+      compression_message = compress_messages_if_needed
 
       # Always send tools definitions to allow multi-step tool calling
       tools_to_send = @tool_registry.all_definitions
@@ -552,13 +563,16 @@ module Clacky
           retry
         else
           @ui&.show_error("Network failed after #{max_retries} retries: #{e.message}")
-          raise Error, "Network connection failed after #{max_retries} retries: #{e.message}"
+          raise AgentError, "Network connection failed after #{max_retries} retries: #{e.message}"
         end
       end
 
       # Clear progress indicator (change to gray and show final time)
       @ui&.clear_progress
 
+      # Show compression message after clearing progress (so it doesn't get deleted)
+      @ui&.show_info(compression_message) if compression_message
+
       track_cost(response[:usage], raw_api_usage: response[:raw_api_usage])
 
       # Handle truncated responses (when max_tokens limit is reached)
@@ -613,7 +627,10 @@ module Clacky
       # Always include content field (some APIs require it even with tool_calls)
       # Use empty string instead of null for better compatibility
       msg[:content] = response[:content] || ""
-      msg[:tool_calls] = format_tool_calls_for_api(response[:tool_calls]) if response[:tool_calls]
+      # Only add tool_calls if they actually exist (don't add empty arrays)
+      if response[:tool_calls]&.any?
+        msg[:tool_calls] = format_tool_calls_for_api(response[:tool_calls])
+      end
       @messages << msg
 
       response
@@ -655,7 +672,8 @@ module Clacky
             denied = true
             user_feedback = confirmation[:feedback]
             feedback = user_feedback if user_feedback
-            results << build_denied_result(call, user_feedback)
+            system_injected = confirmation[:system_injected]
+            results << build_denied_result(call, user_feedback, system_injected)
 
             # Auto-deny all remaining tools
             remaining_calls = tool_calls[(index + 1)..-1] || []
@@ -663,7 +681,7 @@ module Clacky
               reason = user_feedback && !user_feedback.empty? ?
                        user_feedback :
                        "Auto-denied due to user rejection of previous tool"
-              results << build_denied_result(remaining_call, reason)
+              results << build_denied_result(remaining_call, reason, system_injected)
             end
             break
           end
@@ -720,10 +738,11 @@ module Clacky
             error_message: e.message,
             backtrace: e.backtrace&.first(20) # Keep first 20 lines of backtrace
           }
-          
+
           @hooks.trigger(:on_tool_error, call, e)
           @ui&.show_tool_error(e)
-          results << build_error_result(call, e.message)
+          # Use build_denied_result with system_injected=true so LLM knows it can retry
+          results << build_denied_result(call, e.message, true)
         end
       end
 
@@ -736,35 +755,11 @@ module Clacky
 
     def observe(response, tool_results)
       # Add tool results as messages
-      # Using OpenAI format which is compatible with most APIs through LiteLLM
-
-      # CRITICAL: Tool results must be in the same order as tool_calls in the response
-      # Claude/Bedrock API requires this strict ordering
+      # Use Client to format results based on API type (Anthropic vs OpenAI)
       return if tool_results.empty?
 
-      # Create a map of tool_call_id -> result for quick lookup
-      results_map = tool_results.each_with_object({}) do |result, hash|
-        hash[result[:id]] = result
-      end
-
-      # Add results in the same order as the original tool_calls
-      response[:tool_calls].each do |tool_call|
-        result = results_map[tool_call[:id]]
-        if result
-          @messages << {
-            role: "tool",
-            tool_call_id: result[:id],
-            content: result[:content]
-          }
-        else
-          # This shouldn't happen, but add a fallback error result
-          @messages << {
-            role: "tool",
-            tool_call_id: tool_call[:id],
-            content: JSON.generate({ error: "Tool result missing" })
-          }
-        end
-      end
+      formatted_messages = @client.format_tool_results(response, tool_results, model: @config.model)
+      formatted_messages.each { |msg| @messages << msg }
     end
 
     # Interrupt the agent's current run
@@ -1031,9 +1026,6 @@ module Clacky
 
       original_tokens = total_tokens
 
-      @ui&.show_info("Compressing history (~#{original_tokens} tokens -> ~#{TARGET_COMPRESSED_TOKENS} tokens)...")
-      @ui&.show_info("Compression level: #{@compression_level}")
-
       # Find the system message (should be first)
       system_msg = @messages.find { |m| m[:role] == "system" }
 
@@ -1044,8 +1036,6 @@ module Clacky
       # Get messages to compress (everything except system and recent)
       messages_to_compress = @messages.reject { |m| m[:role] == "system" || recent_messages.include?(m) }
 
-      @ui&.show_info("  debug: total=#{@messages.size}, recent=#{recent_messages.size}, to_compress=#{messages_to_compress.size}")
-
       return if messages_to_compress.empty?
 
       # Create hierarchical summary based on compression level
@@ -1065,7 +1055,8 @@ module Clacky
 
       final_tokens = total_message_tokens[:total]
 
-      @ui&.show_info("Compressed (~#{original_tokens} -> ~#{final_tokens} tokens, level #{@compression_level})")
+      # Return compression message (to be shown after clearing progress)
+      "History compressed (~#{original_tokens} -> ~#{final_tokens} tokens, level #{@compression_level})"
     end
 
     # Calculate how many recent messages to keep based on how much we need to compress
@@ -1446,9 +1437,8 @@ module Clacky
 
       # If preview detected an error, auto-deny and provide feedback
       if preview_error && preview_error[:error]
-        @ui&.show_warning("Tool call auto-denied due to preview error")
         feedback = build_preview_error_feedback(call[:name], preview_error)
-        return { approved: false, feedback: feedback }
+        return { approved: false, feedback: feedback, system_injected: true }
       end
 
       # Request confirmation via UI
@@ -1479,7 +1469,7 @@ module Clacky
     private def build_preview_error_feedback(tool_name, error_info)
       case tool_name
       when "edit"
-        "The edit operation will fail because the old_string was not found in the file. " \
+        "Tool edit denied: The edit operation will fail because the old_string was not found in the file. " \
         "Please use file_reader to read '#{error_info[:path]}' first, " \
         "find the correct string to replace, and try again with the exact string (including whitespace)."
       else
@@ -1607,9 +1597,7 @@ module Clacky
           file_size: file_content.length
         }
 
-        @ui&.show_file_error("String to replace not found in file")
-        @ui&.show_file_error("Looking for (first 100 chars):")
-        @ui&.show_file_error(old_string[0..100].inspect)
+        @ui&.show_file_error("Edit file error")
         return {
           error: "String to replace not found in file",
           path: path,
@@ -1653,21 +1641,25 @@ module Clacky
       }
     end
 
-    def build_denied_result(call, user_feedback = nil)
-      message = if user_feedback && !user_feedback.empty?
-                  "Tool use denied by user. User feedback: #{user_feedback}"
-                else
-                  "Tool use denied by user"
-                end
-
-      # For edit tool, remind AI to use the exact same old_string from the previous tool call
-      tool_content = {
-        error: message,
-        user_feedback: user_feedback
-      }
+    def build_denied_result(call, user_feedback = nil, system_injected = false)
+      if system_injected
+        # System-generated feedback (e.g., from preview errors)
+        tool_content = {
+          error: "Tool #{call[:name]} denied: #{user_feedback}",
+          system_injected: true
+        }
+      else
+        # User manually denied or provided feedback
+        message = if user_feedback && !user_feedback.empty?
+                    "Tool use denied by user. User feedback: #{user_feedback}"
+                  else
+                    "Tool use denied by user"
+                  end
 
-      if call[:name] == "edit"
-        tool_content[:hint] = "Keep old_string unchanged. Simply re-read the file if needed and retry with the exact same old_string."
+        tool_content = {
+          error: message,
+          user_feedback: user_feedback
+        }
       end
 
       {

data/lib/clacky/cli.rb

@@ -62,6 +62,13 @@ module Clacky
       end
       config = Clacky::Config.load
 
+      # Show message when using ClaudeCode environment variables
+      if config.config_source == "claude_code"
+        say "🔑 Using API key from ClaudeCode environment variables", :cyan
+        say "   (#{config.base_url})", :white
+        say ""
+      end
+
       unless config.api_key
         say "Error: API key not found. Please run 'clacky config set' first.", :red
         exit 1
@@ -750,14 +757,14 @@ module Clacky
             # Save final session state before exit
             if session_manager && agent.total_tasks > 0
               session_data = agent.to_session_data(status: :exited)
-              session_manager.save(session_data)
+              saved_path = session_manager.save(session_data)
 
               # Show session saved message in output area (before stopping UI)
               session_id = session_data[:session_id][0..7]
               ui_controller.append_output("")
               ui_controller.append_output("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")
               ui_controller.append_output("")
-              ui_controller.append_output("Session saved: #{session_id}")
+              ui_controller.append_output("Session saved: #{saved_path}")
               ui_controller.append_output("Tasks completed: #{agent.total_tasks}")
               ui_controller.append_output("Total cost: $#{agent.total_cost.round(4)}")
               ui_controller.append_output("")
@@ -868,11 +875,6 @@ module Clacky
         if session_manager && agent.total_tasks > 0
           session_manager.save(agent.to_session_data)
         end
-
-        # Show goodbye message
-        say "\n👋 Goodbye! Session stats:", :green
-        say "   Tasks completed: #{agent.total_tasks}", :cyan
-        say "   Total cost: $#{agent.total_cost.round(4)}", :cyan
       end
 
     end