openclacky 0.7.0 → 0.7.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 93be1b075712d3d861045372db397b88a33918d3f9b7e7572d19b0e0b3400da7
-  data.tar.gz: 401b05cf051d54189884860275030b1c71716ae8864231ea2da6bfd1f900f3e6
+  metadata.gz: 05ce65a24427505768d5edd395ace486c9f7ede88a7abcb42770dce4138a319e
+  data.tar.gz: 400a1efafd35cddf6993ba3298830f13eaa1e3cb4502540191e638cb17b22b66
 SHA512:
-  metadata.gz: bca76237b75f2bb9de6b2f9a82238f2174a6de1fa9a9ab377675652e6ec616836e32ef74c2eeb0fadd7cbc417baf00c56277b8dc8299593e133dd014174572f2
-  data.tar.gz: 93a13538a3f50ec847f9db2452d9e99ad5e87e86571e088601fb3329544b5446e55b60bf0cdb72acc53475735a5441152250e8e7ed34bcc14f30a4f819c49098
+  metadata.gz: 8bef68ebcadc6a178a697592e2e92b09d8307d6bd789171a21eedb2b3296b23071fe761caf762dfe6e2e399ed76dcc028d232190ae8ce5652c9387337a9c6a39
+  data.tar.gz: f43e0362780a85166435f572ad42a38654d62f9acc66401e5c229bfd6f27605d75844ee232d3f334fbb8414a0b2d6686b2164a10eb4ebe4ef90b54a021bbf163

data/.clacky/skills/commit/SKILL.md

@@ -9,6 +9,17 @@ user-invocable: true
 
 This skill helps users create well-structured, semantic git commits by analyzing changes and suggesting appropriate commit messages.
 
+## ⚠️ CRITICAL REQUIREMENT: SINGLE-LINE COMMITS ONLY
+
+**ALL commit messages created by this skill MUST be single-line only.**
+
+- ✅ DO: `git commit -m "feat: add user authentication"`
+- ❌ DON'T: Multi-line commits with body text
+- ❌ DON'T: Multiple `-m` flags
+- ❌ DON'T: Commit messages with `\n` or additional paragraphs
+
+Keep commits concise and focused. If more detail is needed, suggest adding it separately in PR descriptions or documentation.
+
 ## Overview
 
 This skill automates the process of reviewing git changes and creating meaningful, conventional commits following the semantic commit format (feat/fix/chore/test).
@@ -62,12 +73,14 @@ Based on the analysis, generate commit messages following the conventional commi
 - `style`: Code style changes (formatting, whitespace)
 - `perf`: Performance improvements
 
-**Guidelines**:
+**CRITICAL GUIDELINES**:
+- **MUST BE SINGLE-LINE**: Commit messages MUST be a single line only. DO NOT create multi-line commit messages.
 - Keep messages concise (ideally under 50 characters)
 - Use imperative mood ("add feature" not "added feature")
 - Don't end with a period
 - Be specific but brief
 - One logical change per commit
+- If more detail is needed, suggest adding it in PR description or commit body separately, but the initial commit MUST be single-line
 
 **Examples**:
 - `feat: add user authentication`
@@ -120,10 +133,16 @@ For each approved commit:
 # Stage specific files
 git add <file1> <file2> ...
 
-# Create commit with message
+# Create commit with SINGLE-LINE message only
 git commit -m "<type>: <description>"
 ```
 
+**IMPORTANT**: 
+- Use ONLY `git commit -m "single line message"` format
+- DO NOT use multi-line commits with additional body text
+- DO NOT use `-m` flag multiple times
+- Keep the commit message as a single, concise line
+
 Provide feedback after each commit:
 - Confirm successful commit
 - Show commit hash
@@ -151,8 +170,12 @@ git diff <file>
 # Stage files
 git add <file>
 
-# Create commit
-git commit -m "message"
+# Create commit (SINGLE-LINE only)
+git commit -m "type: single line description"
+
+# NEVER use multi-line format like:
+# git commit -m "title" -m "body"  ❌ DON'T DO THIS
+# git commit -m "title\n\nbody"    ❌ DON'T DO THIS
 
 # View commit history
 git log --oneline -n 5
@@ -203,10 +226,12 @@ Next steps: Review with 'git log' or push with 'git push'
 ## Best Practices
 
 ### Commit Message Rules
+- **MUST be single-line only** - Never use multi-line commit messages
 - Start with lowercase (except proper nouns)
 - Use present tense imperative
 - Be specific but concise
 - Focus on "what" and "why", not "how"
+- Maximum 72 characters for the single line
 
 ### Commit Organization
 - One logical change per commit

data/.clackyrules

@@ -25,7 +25,8 @@ It provides chat functionality and autonomous AI agent capabilities with tool us
 - **IMPORTANT**: All code comments must be written in English
 - Add descriptive comments for complex logic
 - Use clear, self-documenting code with English naming
-- **IMPORTANT**: Always use inline `private` with method definitions (e.g., `private def method_name`). Do NOT use standalone `private` keyword
+- **IMPORTANT**: Always use inline `private` with instance method definitions (e.g., `private def method_name`). Do NOT use standalone `private` keyword
+- **IMPORTANT**: For class methods (`def self.method_name`), do NOT use `private`. Class methods should be public
 
 ### Architecture Patterns
 - Tools inherit from `Clacky::Tools::Base`
@@ -45,6 +46,7 @@ It provides chat functionality and autonomous AI agent capabilities with tool us
 - **IMPORTANT**: When developing new features, write RSpec tests as needed and ensure they pass
 - **DO NOT** write custom test scripts unless explicitly requested by the user
 - **DO NOT** create markdown documentation unless explicitly requested by the user
+- **IMPORTANT**: When testing clacky commands or debugging, always use `bundle exec ruby bin/clacky` instead of the global `clacky` command. The global command loads the system-installed gem version (e.g., `openclacky-0.7.0`), not your local development code
 
 ### Tool Development
 When adding new tools:

data/CHANGELOG.md

@@ -7,6 +7,107 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.1] - 2026-02-24
+
+This release brings significant user experience improvements, new interaction modes, and enhanced agent capabilities.
+
+### 🎯 Major Features
+
+**Subagent System**
+- Deploy subagent for parallel task execution
+- Subagent mode with invoke_skill tool and code-explorer skill integration
+- Environment variable support and model type system
+
+**Command Experience**
+- Tab completion for slash commands
+- Ctrl+O toggle expand in diff view
+- JSON mode for structured output
+- Streamlined command selection workflow with improved filtering
+
+**Agent Improvements**
+- Idle compression with auto-trigger (180s timer)
+- Improved interrupt handling for tool execution
+- Preview display for edit and write tools in auto-approve mode
+- Enable preview display in auto-approve mode
+
+**Configuration UI**
+- Auto-save to config modal
+- Improved model management UI
+- Better error handling and validation
+
+### Added
+- Quick start guides in English and Chinese
+- Config example and tests for AgentConfig
+
+### Improved
+- Refactored agent architecture (split agent.rb, moved file locations)
+- Simplified thread management in chat command
+- Dynamic width ratio instead of fixed MAX_CONTENT_WIDTH
+- API error messages with HTML detection and truncation
+- Help command handling
+
+### Changed
+- Removed deprecated Config class (replaced by AgentConfig)
+- Removed confirm_edits permission mode
+- Removed keep_recent_messages configuration
+- Removed default model value
+
+### Fixed
+- Use ToolCallError instead of generic Error in tool registry
+- Handle AgentInterrupted exception during idle compression
+- Handle XML tag contamination in JSON tool parameters
+- Prevent modal flickering on validation failure
+- Update agent client when switching models to prevent stale config
+- Update is_safe_operation to not use removed editing_tool? method
+
+### More
+- Optimize markdown horizontal rule rendering
+- Add debug logging throughout codebase
+
+## [0.7.0] - 2026-02-06
+
+This is a major release with significant improvements to skill system, conversation memory management, and user experience.
+
+### 🎯 Major Features
+
+**Skill System**
+- Complete skill framework allowing users to extend AI capabilities with custom workflows
+- Skills can be invoked using shorthand syntax (e.g., `/commit`, `/gem-release`)
+- Support for user-created skills in `.clacky/skills/` directory
+- Built-in skills: commit (smart Git helper), gem-release (automated publishing)
+
+**Memory Compression**
+- Intelligent message compression to handle long conversations efficiently
+- LLM-based compression strategy that preserves context while reducing tokens
+- Automatic compression triggered based on message count and token usage
+- Significant reduction in API costs for extended sessions
+
+**Configuration Improvements**
+- API key validation on startup with helpful prompts
+- Interactive configuration UI with modal components
+- Source tracking for configuration (file, environment, defaults)
+- Better error messages and user guidance
+
+### Added
+- Request user feedback tool for interactive prompts during execution
+- Version display in welcome banner
+- File size limits for file_reader tool to prevent performance issues
+- Debug logging throughout the codebase
+
+### Improved
+- CLI output formatting and readability
+- Error handling with comprehensive debug information
+- Test coverage with 367 passing tests
+- Tool call output optimization for cleaner logs
+
+### Changed
+- Simplified CLI architecture by removing unused code
+- Enhanced modal component with new configuration features
+
+### Fixed
+- Message compression edge cases
+- Various test spec improvements
+
 ## [0.6.4] - 2026-02-03
 
 ### Added
@@ -176,7 +277,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 - **Agent Mode**: Autonomous AI agent with tool execution capabilities
-- **Built-in Tools**: 
+- **Built-in Tools**:
   - `safe_shell` - Safe shell command execution with security checks
   - `file_reader` - Read file contents
   - `write` - Create/overwrite files with diff preview
@@ -188,7 +289,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - `todo_manager` - Task planning and tracking
   - `run_project` - Project dev server management
 - **Session Management**: Save, resume, and list conversation sessions
-- **Permission Modes**: 
+- **Permission Modes**:
   - `auto_approve` - Automatically execute all tools
   - `confirm_safes` - Auto-execute safe operations, confirm risky ones
   - `confirm_edits` - Confirm file edits only

data/README.md

@@ -1,75 +1,66 @@
 # OpenClacky
 
-OpenClacky = Lovable + Supabase
-
-## Features
+[![Build](https://img.shields.io/github/actions/workflow/status/clacky-ai/open-clacky/main.yml?label=build&style=flat-square)](https://github.com/clacky-ai/open-clacky/actions)
+[![Release](https://img.shields.io/gem/v/openclacky?label=release&style=flat-square&color=blue)](https://rubygems.org/gems/openclacky)
+[![Ruby](https://img.shields.io/badge/ruby-%3E%3D%203.1.0-red?style=flat-square)](https://www.ruby-lang.org)
+[![Downloads](https://img.shields.io/gem/dt/openclacky?label=downloads&style=flat-square&color=brightgreen)](https://rubygems.org/gems/openclacky)
+[![License](https://img.shields.io/badge/license-MIT-lightgrey?style=flat-square)](LICENSE.txt)
 
-- 💬 Interactive chat sessions with AI models
-- 🤖 Autonomous AI agent with tool use capabilities
-- 📝 Enhanced input with multi-line support and Unicode (Chinese, etc.)
-- 🖼️ Paste images from clipboard (macOS/Linux)
-- 🚀 Single-message mode for quick queries
-- 🔐 Secure API key management
-- 📝 Multi-turn conversation support
-- 🎨 Colorful terminal output
-- 🌐 OpenAI-compatible API support (OpenAI, Gitee AI, DeepSeek, etc.)
-- 🛠️ Rich built-in tools: file operations, web search, code execution, and more
-- ⚡ Prompt caching support for Claude models (reduces costs up to 90%)
+OpenClacky = Lovable + Supabase
 
-## Installation
+**OpenClacky** is a CLI tool for building full-stack web applications — no technical background required. We spent months crafting a **Rails for AI** full-stack architecture that is fully production-ready, with one-click deployment, isolated dev/production environments, and automatic backups.
 
-### Quick Install (Recommended)
+OpenClacky's goal is to deliver the best balance of **AI quality, AI cost, and AI speed**.
 
-**One-line installation** (auto-detects your system):
+## Quick start
 
 ```bash
-curl -sSL https://raw.githubusercontent.com/clacky-ai/open-clacky/main/scripts/install.sh | bash
+$ openclacky
 ```
 
-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
+- `/config` — Set your API key, model, and base URL
+- `/new <project-name>` — Create a new project
+- Type your requirements and start building
+
+## Why OpenClacky?
+
+|  | **Claude Code** | **Lovable + Supabase** | **OpenClacky** |
+|---|---|---|---|
+| **Target Users** | Professional developers | Non-technical users | Non-technical users |
+| **Tech Stack** | Any | React + Supabase | Rails (full-stack) |
+| **Full-Stack Integration** | ❌ DIY | ⚠️ Frontend/backend split | ✅ Unified full-stack |
+| **Production-Ready** | ❌ Manual setup | ⚠️ Relies on third-party | ✅ Built-in |
+| **One-Click Deploy** | ❌ | ⚠️ Platform lock-in | ✅ Deploy anywhere |
+| **Dev/Prod Isolation** | ❌ | ❌ | ✅ Automatic |
+| **Automatic Backups** | ❌ | ⚠️ Paid feature | ✅ Built-in |
+| **AI Cost Control** | ❌ Pay per token | ❌ Subscription | ✅ Optimally balanced |
+| **Data Ownership** | ✅ | ❌ Platform-owned | ✅ Fully yours |
+| **Interface** | Terminal | Web UI | Terminal |
 
-### Method 1: Homebrew (macOS/Linux)
+## Features
 
-**Best for macOS users** - Automatically handles Ruby dependencies:
+- [x] `/new <project-name>` — Scaffold a full-stack Rails web app in seconds
+- [x] **Skills system** — Specialized AI workflows for deploy, frontend design, PDF, PPTX, and more
+- [x] **Cost monitoring & compression** — Real-time cost tracking, automatic message compression (up to 90% savings)
+- [x] **One-click deployment** — Ship to production with a single command (with Clacky CDE)
+- [x] **Autonomous AI agent** — Multi-step task execution with undo/redo
+- [x] **Multi-provider support** — OpenAI, Anthropic, DeepSeek, and any OpenAI-compatible API
+- [ ] **Time Machine** — Visual history to rewind and branch any point in your project *(coming soon)*
 
-```bash
-brew tap clacky-ai/openclacky
-brew install openclacky
-```
+## Installation
 
-### Method 2: RubyGems (If you already have Ruby >= 3.1.0)
+### Method 1: One-line Install (Recommended)
 
 ```bash
-gem install openclacky
+/bin/bash -c "$(curl -sSL https://raw.githubusercontent.com/clacky-ai/open-clacky/main/scripts/install.sh)"
 ```
 
-### Method 3: From Source (For Development)
+### Method 2: RubyGems
 
-```bash
-git clone https://github.com/clacky-ai/open-clacky.git
-cd open-clacky
-bundle install
-bin/clacky
-```
-
-### System Requirements
-
-- **Ruby**: >= 3.1.0 (automatically handled by Homebrew)
-- **OS**: macOS, Linux, or Windows (WSL)
-
-### Uninstallation
+**Requirements:** Ruby >= 3.1.0
 
 ```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
+gem install openclacky
 ```
 
 ## Configuration
@@ -77,141 +68,59 @@ gem uninstall openclacky   # If installed via gem
 Before using Clacky, you need to configure your settings:
 
 ```bash
-clacky config set
+$ openclacky
+
+- /config
 ```
 
 You'll be prompted to enter:
 - **API Key**: Your API key from any OpenAI-compatible provider
-- **Model**: Model name (e.g., `gpt-4`, `deepseek-chat`)
-- **Base URL**: OpenAI-compatible API endpoint (e.g., `https://api.openai.com/v1`)
-
-To view your current configuration:
-
-```bash
-clacky config show
-```
+- **Model**: Model name
+- **Base URL**: OpenAI-compatible API endpoint
 
 ## Usage
 
-### 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.
-
-```bash
-# Start interactive agent (will prompt for tasks)
-clacky agent
-
-# Start with an initial task, then continue interactively
-clacky agent "Create a README.md file for my project"
-
-# Auto-approve all tool executions
-clacky agent --mode=auto_approve
-
-# Work in a specific project directory
-clacky agent --path /path/to/project
-
-#### Permission Modes
-
-- `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
+### Scenario 1: Create a new web app
 
 ```bash
---path PATH                    # Project directory (defaults to current directory)
---mode MODE                    # Permission mode
---verbose                      # Show detailed output
+$ openclacky
+> /new my-blog
+# OpenClacky scaffolds a full-stack Rails app in seconds
+# > Add a posts page with title, content, and author fields
+# > Deploy to production
+# > exit
 ```
 
-#### Cost Control & Memory Management
-
-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).
-
-- **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)
-
-### List Available Tools
-
-View all built-in tools:
+### Scenario 2: Build a feature in an existing project
 
 ```bash
-clacky tools
+$ cd ~/my-project && openclacky
+# > Add user authentication with email and password
+# > Write tests for the auth flow
+# > exit
 ```
 
-#### Built-in Tools
-
-- **todo_manager** - Manage TODO items for task planning and tracking
-- **file_reader** - Read file contents
-- **write** - Create or overwrite files
-- **edit** - Make precise edits to existing files
-- **glob** - Find files by pattern matching
-- **grep** - Search file contents with regex
-- **shell** - Execute shell commands
-- **web_search** - Search the web for information
-- **web_fetch** - Fetch and parse web page content
-
-### Available Commands
+### Scenario 3: Ask questions about your codebase
 
 ```bash
-clacky agent [MESSAGE]    # Run autonomous agent with tool use
-clacky tools              # List available tools
-clacky config set         # Set your API key
-clacky config show        # Show current configuration
-clacky version            # Show clacky version
-clacky help               # Show help information
+$ openclacky
+# > How does the payment module work?
+# > Where is the user session managed?
+# > exit
 ```
 
-## Examples
-
-### Agent Examples
+## Install from Source
 
 ```bash
-# Start interactive agent session
-clacky agent
-# Then type tasks interactively:
-# > Create a TODO.md file with 3 example tasks
-# > Now add more items to the TODO list
-# > 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
-
-# Using TODO manager for complex tasks
-clacky agent "Implement a new feature with user authentication"
-# Agent will:
-# 1. Use todo_manager to create a task plan
-# 2. Add todos: "Research current auth patterns", "Design auth flow", etc.
-# 3. Complete each todo step by step
-# 4. Mark todos as completed as work progresses
-# > exit
+git clone https://github.com/clacky-ai/open-clacky.git
+cd open-clacky
+bundle install
+bin/clacky
 ```
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
-
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
-
-### Testing Agent Features
-
-After making changes to agent-related functionality (tools, system prompts, agent logic, etc.), test with this command:
-
-```bash
-# Test agent with a complex multi-step task using auto-approve mode
-echo "Create a simple calculator project with index.html, style.css, and script.js files" | \
-  bin/clacky agent --mode=auto_approve --path=tmp --max-iterations=20
-
-# Expected: Agent should plan tasks (add TODOs), execute them (create files),
-# and track progress (mark TODOs as completed)
-```
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/clacky` for an interactive prompt that will allow you to experiment.
 
 ## Contributing
 

data/bin/clarky

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+
+# Display typo correction message
+warn "\nNote: 'clarky' appears to be a typo!"
+warn "The correct command is 'clacky'"
+
+warn "\nRedirecting to the correct command...\n\n"
+
+# Redirect to clacky
+clacky_path = File.expand_path("clacky", __dir__)
+exec(clacky_path, *ARGV)

data/docs/HOW-TO-USE-CN.md

@@ -0,0 +1,96 @@
+# OpenClacky 使用指南
+
+## 安装
+
+```bash
+gem install openclacky
+```
+
+**系统要求：** Ruby >= 3.1
+
+## 快速开始
+
+### 1. 启动 Clacky
+
+```bash
+clacky
+```
+
+### 2. 配置 API Key（首次使用）
+
+在聊天界面中输入：
+
+```
+/config
+```
+
+然后按提示设置你的 API key：
+- **OpenAI**：从 https://platform.openai.com/api-keys 获取
+- **Anthropic**：从 https://console.anthropic.com/ 获取
+- **MiniMax**：国内推荐，https://platform.minimaxi.com/
+- **OpenRouter**：聚合多个 AI 模型，https://openrouter.ai/
+
+### 3. 开始对话
+
+直接在聊天框输入你的问题或需求：
+
+```
+帮我写一个解析 CSV 文件的 Ruby 脚本
+```
+
+```
+创建一个网页爬虫提取文章标题
+```
+
+## 核心功能
+
+### 🎯 自主代理模式
+Clacky 可以自动执行复杂任务，内置多种工具：
+- **文件操作**：读取、写入、编辑、搜索文件
+- **网页访问**：浏览网页、搜索信息
+- **代码执行**：运行 shell 命令、测试代码
+- **项目管理**：Git 操作、测试、部署
+
+### 🔌 技能系统
+使用简写命令调用强大的技能：
+
+```
+/commit          # 智能 Git 提交助手
+/gem-release     # 自动化 gem 发布流程
+```
+
+你还可以在 `.clacky/skills/` 目录创建自己的技能！
+
+### 💬 智能记忆管理
+- **自动压缩**长对话内容
+- **保留上下文**同时降低 token 成本
+- **智能总结**对话历史
+
+### ⚙️ 简单配置
+- 交互式设置向导
+- 支持多个 API 提供商
+- 成本追踪和使用限制
+- 常用场景的智能默认值
+
+## 聊天中的常用命令
+
+```
+/config          # 配置 API 设置
+/help            # 显示可用命令
+/skills          # 列出可用技能
+```
+
+## 为什么选择 OpenClacky？
+
+✅ **安装简单** - 一条命令安装，立即开始对话  
+✅ **功能强大** - 自主执行复杂任务  
+✅ **可扩展** - 为你的工作流创建自定义技能  
+✅ **省钱高效** - 智能记忆压缩节省 token 费用  
+✅ **多平台** - 支持 OpenAI、Anthropic、MiniMax、OpenRouter 等  
+✅ **质量保证** - 367+ 测试用例确保可靠性  
+
+## 了解更多
+
+- GitHub：https://github.com/clacky-ai/open-clacky
+- 问题反馈：https://github.com/clacky-ai/open-clacky/issues
+- 当前版本：0.7.0