openclacky 0.7.0 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 93be1b075712d3d861045372db397b88a33918d3f9b7e7572d19b0e0b3400da7
-  data.tar.gz: 401b05cf051d54189884860275030b1c71716ae8864231ea2da6bfd1f900f3e6
+  metadata.gz: d00dc4e2243d55c56a3f5df9838517d7588a96137b18348c750e42374d15f7d8
+  data.tar.gz: 0e0fb9b1fce48ac1fb5542e3fb4e5b3744aecb4cd9a51bd15ffa6ada3f892212
 SHA512:
-  metadata.gz: bca76237b75f2bb9de6b2f9a82238f2174a6de1fa9a9ab377675652e6ec616836e32ef74c2eeb0fadd7cbc417baf00c56277b8dc8299593e133dd014174572f2
-  data.tar.gz: 93a13538a3f50ec847f9db2452d9e99ad5e87e86571e088601fb3329544b5446e55b60bf0cdb72acc53475735a5441152250e8e7ed34bcc14f30a4f819c49098
+  metadata.gz: ab6df815f041afa4fa586547299a61562e544de3ae2425b2e9c7a7c9256c05e7b0f79dc824553ccd810939bf3cf3d6e1376b32f4d8a92acedb03efedcfa1e552
+  data.tar.gz: a6409dd1ab5456f70ae2f6f576f209d47bb4140956caa14ee18815d91c3c901415219212cc73138e959b43531be9f450938fd8e767e63c1075444c520147fa7e

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,50 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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 +220,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 +232,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/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

data/docs/HOW-TO-USE.md

@@ -0,0 +1,94 @@
+# How to Use OpenClacky
+
+## Installation
+
+```bash
+gem install openclacky
+```
+
+**Requirements:** Ruby >= 3.1
+
+## Quick Start
+
+### 1. Start Clacky
+
+```bash
+clacky
+```
+
+### 2. Configure API Key (First Time)
+
+In the chat interface, type:
+
+```
+/config
+```
+
+Then follow the prompts to set your API key:
+- **OpenAI**: Get key from https://platform.openai.com/api-keys
+- **Anthropic**: Get key from https://console.anthropic.com/
+
+### 3. Start Chatting
+
+Just type your questions or requests in the chat:
+
+```
+Help me write a Ruby script to parse CSV files
+```
+
+```
+Create a web scraper for extracting article titles
+```
+
+## Key Features
+
+### 🎯 Autonomous Agent Mode
+Clacky can automatically execute complex tasks using built-in tools:
+- **File Operations**: Read, write, edit, search files
+- **Web Access**: Browse and search the web
+- **Code Execution**: Run shell commands and test code
+- **Project Management**: Git operations, testing, deployment
+
+### 🔌 Skill System
+Use powerful skills with simple shorthand commands:
+
+```
+/commit          # Smart git commit helper
+/gem-release     # Automated gem publishing
+```
+
+Create your own skills in `.clacky/skills/` directory!
+
+### 💬 Smart Memory Management
+- **Automatic compression** for long conversations
+- **Context preservation** while reducing token costs
+- **Intelligent summarization** of conversation history
+
+### ⚙️ Easy Configuration
+- Interactive setup wizard
+- Support for multiple API providers
+- Cost tracking and usage limits
+- Smart defaults for common use cases
+
+## Common Commands in Chat
+
+```
+/config          # Configure API settings
+/help            # Show available commands
+/skills          # List available skills
+```
+
+## Why Choose OpenClacky?
+
+✅ **Simple Setup** - Just `gem install` and start chatting  
+✅ **Powerful Agent** - Executes complex tasks autonomously  
+✅ **Extensible** - Create custom skills for your workflows  
+✅ **Cost-Effective** - Smart memory compression saves tokens  
+✅ **Multi-Provider** - Works with OpenAI and Anthropic  
+✅ **Well-Tested** - 367+ passing tests ensure reliability  
+
+## Learn More
+
+- GitHub: https://github.com/clacky-ai/open-clacky
+- Report Issues: https://github.com/clacky-ai/open-clacky/issues
+- Version: 0.7.0

data/docs/config.example.yml

@@ -0,0 +1,27 @@
+# Clacky Configuration File
+# This is a top-level array of model configurations
+# The first model in the array is used as the default
+
+# Claude Sonnet 4 (default - first in array)
+- model: "claude-sonnet-4"
+  api_key: "your-api-key-here"
+  base_url: "https://api.anthropic.com"
+  anthropic_format: true
+
+# Claude Opus 4
+- model: "claude-opus-4"
+  api_key: "your-api-key-here"
+  base_url: "https://api.anthropic.com"
+  anthropic_format: true
+
+# OpenAI GPT-4
+- model: "gpt-4"
+  api_key: "your-openai-api-key-here"
+  base_url: "https://api.openai.com/v1"
+  anthropic_format: false
+
+# Custom model (e.g., local or third-party)
+- model: "custom-model"
+  api_key: "your-custom-api-key"
+  base_url: "https://your-api-endpoint.com"
+  anthropic_format: false