openclacky 0.8.8 → 0.8.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 94fe2f9fd0477231e7411c762aacfecc9eb15b87f027366d7598c73e738499c0
-  data.tar.gz: 41e84ac897d4d120dec9c7d88f69b35f82779adc2963a13dd099fd686d926ec3
+  metadata.gz: 9fbd7535e2cc98aadf0d9bbc3ff8dcc3db04669ba5c972ec00b41c338f1c3ae5
+  data.tar.gz: 345be84b2b010db47ccdd0454b0214463117519fe5d029440290c0187006ff4a
 SHA512:
-  metadata.gz: 1f28d84aab760ca2c53cc0c558ec82fb3b0bebc8b2fe5279021f3d0cc5c896ebe5dda7fc8f060f7d77609bb6b6aedffa064ef1897185db01a9b6f4e022364646
-  data.tar.gz: 64b71cd3c7793201f16600b100088cd739671c9c414252dadc6a593600f15271fc79a953877e59bc2014af929888384e3640ee78e7c1227c8b72e81f919ca72c
+  metadata.gz: 317f05f87355eb3c58da51dde828b6fafd3abbc7cc8bfa874c19445b5a783f7687ee84c7e8ddcf59573b7a554687ee8b2c9e5a8ed5d14993b6167fe5a656a881
+  data.tar.gz: ce669491b51cbff8f3fbdea2262d51d206377617d69ad981ac5025b824b86638d78d248ea6dcd89f4b9ecca92d042efa91b783dff220bec5c4ac348c8535b6d6

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

@@ -207,52 +207,11 @@ Based on the holistic analysis, generate commit messages following the conventio
 - `refactor: simplify database connection logic` (not one commit per file)
 - `docs: update API documentation` (only if pure documentation change)
 
-### 6. Present Suggestions
+### 6. Execute Commits Immediately
 
-Show the user:
-- **The overall purpose/goal you identified**
-- List of proposed commits (prefer fewer, consolidated commits)
-- Files included in each commit
-- Commit message for each group
-- **Brief explanation of WHY changes were grouped this way**
+No confirmation needed — analyze, group, and commit right away.
 
-Format:
-```
-Overall goal: Implementing user authentication system
-
-Proposed commits:
-
-Commit 1: feat: add user authentication
-  - lib/api/auth.rb (authentication logic)
-  - lib/user.rb (user model updates)
-  - lib/session.rb (session management)
-  - spec/api/auth_spec.rb (tests)
-  - spec/user_spec.rb (updated user tests)
-  - config/routes.rb (auth routes)
-  
-  Reason: All these files work together to implement the authentication
-  feature. Tests and configuration belong with the implementation.
-
-Commit 2: fix: resolve database timeout issue
-  - lib/database/connection.rb
-  - spec/database/connection_spec.rb
-  
-  Reason: Separate bug fix unrelated to authentication.
-
-Total: 2 commits (not 6+ small commits)
-```
-
-### 7. Get User Confirmation
-
-Ask the user:
-- Review the proposed commits
-- Confirm if they want to proceed
-- Allow modifications if needed
-- Get explicit approval before committing
-
-### 8. Execute Commits
-
-For each approved commit:
+For each commit group:
 ```bash
 # Stage specific files
 git add <file1> <file2> ...
@@ -261,22 +220,17 @@ git add <file1> <file2> ...
 git commit -m "<type>: <description>"
 ```
 
-**IMPORTANT**: 
+**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
-- Display summary
-
-### 9. Final Summary
+### 7. Final Summary
 
-After all commits:
-- Show total number of commits created
-- List all commit messages
+After all commits, show:
+- Total number of commits created
+- Each commit hash + message
 - Suggest next steps (e.g., git push)
 
 ## Commands Used
@@ -370,11 +324,7 @@ AI (CORRECT APPROACH):
 
    Total: 3 meaningful commits instead of 5 fragmented ones
 
-   Do you want to proceed? (yes/no)
-
-User: yes
-
-AI:
+AI (executes immediately, no confirmation):
 Commit 1 created (a1b2c3d): feat: add user registration
 Commit 2 created (e4f5g6h): fix: correct password validation logic
 Commit 3 created (i7j8k9l): chore: update gem dependencies
@@ -438,11 +388,8 @@ For each set of changes, ask:
 
 ## Safety Features
 
-- Always review changes before committing
-- Require user confirmation before executing commits
-- Show exactly which files will be in each commit
-- Allow user to modify suggestions
-- Never force commits without approval
+- Always review changes before committing (read diffs first)
+- Execute commits immediately after analysis — no confirmation step
 - Preserve git history integrity
 
 ## Integration with Workflow

data/CHANGELOG.md

@@ -7,6 +7,31 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.8.9] - 2026-03-13
+
+### Added
+- **Markdown rendering in WebUI chat**: assistant responses are now rendered as rich markdown — headings, bold, code blocks, lists, and inline code are all formatted properly instead of displayed as raw text
+- **Session naming with auto-name and inline rename**: sessions are automatically named after the first exchange; users can double-click any session in the sidebar to rename it inline
+- **Session info bar with live status animation**: a slim bar below the chat header shows the session name, working directory, and a pulsing animation while the agent is thinking or executing tools
+- **Restore last 5 sessions on startup**: the WebUI now reopens the five most recent sessions on startup instead of just the last one
+- **Image and file support for Feishu and WeCom**: users can now send images and file attachments through Feishu and WeCom IM channels; the agent reads and processes them like any other input
+- **Idle compression in WebUI**: the agent now compresses long conversation history automatically when the session has been idle, keeping context efficient without manual intervention
+
+### Improved
+- **Onboard flow**: soul setup is now non-blocking; the confirmation page is skipped for a faster first-run experience; onboard now asks the user to name the AI first, then collects the user profile
+- **Token usage display ordering**: the token usage line in WebUI now always appears below the assistant message bubble, not above it
+
+### Fixed
+- **Token usage line disappears after page refresh**: token usage data is now persisted in session history and correctly re-rendered when the page is reloaded
+- **Shell tool hangs on background commands**: commands containing `&` (background operator) no longer cause the shell tool to block indefinitely
+- **White flash on page load**: the page is now hidden until boot completes, preventing a flash of unstyled content or the wrong view on startup
+- **Theme flash on refresh**: the theme (dark/light) is now initialized inline in `<head>` so the correct colours are applied before any content renders
+- **Onboard flash on reload**: the onboard panel no longer briefly appears when a session already exists during soul setup
+
+### More
+- Rename channels "Test" button to "Diagnostics" for clarity
+- Default-highlight the first item in skill autocomplete
+
 ## [0.8.8] - 2026-03-13
 
 ### Added

data/lib/clacky/agent/cost_tracker.rb

@@ -37,8 +37,8 @@ module Clacky
           end
         end
 
-        # Display token usage statistics for this iteration
-        display_iteration_tokens(usage, iteration_cost)
+        # Collect token usage data for this iteration (returned to caller for deferred display)
+        token_data = collect_iteration_tokens(usage, iteration_cost)
 
         # Update session bar cost in real-time (don't wait for agent.run to finish)
         @ui&.update_sessionbar(cost: @total_cost)
@@ -75,6 +75,9 @@ module Clacky
             @task_cache_stats[:cache_hit_requests] += 1
           end
         end
+
+        # Return token_data so the caller can display it at the right moment
+        token_data
       end
 
       # Estimate token count for a message content
@@ -147,10 +150,13 @@ module Clacky
 
       private
 
-      # Display token usage for current iteration
+      # Collect token usage data for current iteration and return it.
+      # Does NOT call @ui directly — the caller is responsible for displaying
+      # at the right moment (e.g. after show_assistant_message).
       # @param usage [Hash] Usage data from API
       # @param cost [Float] Cost for this iteration
-      def display_iteration_tokens(usage, cost)
+      # @return [Hash] token_data ready for show_token_usage
+      def collect_iteration_tokens(usage, cost)
         prompt_tokens = usage[:prompt_tokens] || 0
         completion_tokens = usage[:completion_tokens] || 0
         total_tokens = usage[:total_tokens] || (prompt_tokens + completion_tokens)
@@ -161,8 +167,7 @@ module Clacky
         delta_tokens = total_tokens - @previous_total_tokens
         @previous_total_tokens = total_tokens  # Update for next iteration
 
-        # Prepare data for UI to format and display
-        token_data = {
+        {
           delta_tokens: delta_tokens,
           prompt_tokens: prompt_tokens,
           completion_tokens: completion_tokens,
@@ -171,9 +176,6 @@ module Clacky
           cache_read: cache_read,
           cost: cost
         }
-
-        # Let UI handle formatting and display
-        @ui&.show_token_usage(token_data)
       end
     end
   end

data/lib/clacky/agent/llm_caller.rb

@@ -44,8 +44,11 @@ module Clacky
           @ui&.clear_progress
         end
 
-        # Track cost for all LLM calls
-        track_cost(response[:usage], raw_api_usage: response[:raw_api_usage])
+        # Track cost and collect token usage data.
+        # token_data is returned to the caller so it can be displayed
+        # after show_assistant_message (ensuring correct ordering in WebUI).
+        token_data = track_cost(response[:usage], raw_api_usage: response[:raw_api_usage])
+        response[:token_usage] = token_data
 
         response
       end

data/lib/clacky/agent/message_compressor.rb

@@ -108,7 +108,7 @@ module Clacky
     def parse_compressed_result(result, chunk_path: nil)
       # Return the compressed result as a single assistant message
       # Keep the <analysis> or <summary> tags as they provide semantic context
-      content = result.strip
+      content = result.to_s.strip
 
       if content.empty?
         []

data/lib/clacky/agent/session_serializer.rb

@@ -9,6 +9,7 @@ module Clacky
       # @param session_data [Hash] Saved session data
       def restore_session(session_data)
         @session_id = session_data[:session_id]
+        @name = session_data[:name] || ""
         @messages = session_data[:messages]
         @todos = session_data[:todos] || []  # Restore todos from session
         @iterations = session_data.dig(:stats, :total_iterations) || 0
@@ -64,24 +65,6 @@ module Clacky
       # @param error_message [String] Error message if status is :error
       # @return [Hash] Session data ready for serialization
       def to_session_data(status: :success, error_message: nil)
-        # Get last real user message for preview (skip compressed system messages)
-        last_user_msg = @messages.reverse.find do |m|
-          m[:role] == "user" && !m[:content].to_s.start_with?("[SYSTEM]")
-        end
-
-        # Extract preview text from last user message
-        last_message_preview = if last_user_msg
-          content = last_user_msg[:content]
-          if content.is_a?(String)
-            # Truncate to 100 characters for preview
-            content.length > 100 ? "#{content[0..100]}..." : content
-          else
-            "User message (non-string content)"
-          end
-        else
-          "No messages"
-        end
-
         stats_data = {
           total_tasks: @total_tasks,
           total_iterations: @iterations,
@@ -98,6 +81,7 @@ module Clacky
 
         {
           session_id: @session_id,
+          name: @name,
           created_at: @created_at,
           updated_at: Time.now.iso8601,
           working_dir: @working_dir,
@@ -116,8 +100,7 @@ module Clacky
             verbose: @config.verbose
           },
           stats: stats_data,
-          messages: @messages,
-          last_user_message: last_message_preview
+          messages: @messages
         }
       end
 
@@ -211,6 +194,9 @@ module Clacky
                 ui.show_tool_call(name, args)
               end
 
+              # Emit token usage stored on this message (for history replay display)
+              ui.show_token_usage(ev[:token_usage]) if ev[:token_usage]
+
             when "user"
               # Anthropic-format tool results (role: user, content: array of tool_result blocks)
               next unless ev[:content].is_a?(Array)

data/lib/clacky/agent.rb

@@ -32,16 +32,20 @@ module Clacky
     include TimeMachine
     include MemoryUpdater
 
-    attr_reader :session_id, :messages, :iterations, :total_cost, :working_dir, :created_at, :total_tasks, :todos,
-                :cache_stats, :cost_source, :ui, :skill_loader, :agent_profile
+    attr_reader :session_id, :name, :messages, :iterations, :total_cost, :working_dir, :created_at, :total_tasks, :todos,
+                :cache_stats, :cost_source, :ui, :skill_loader, :agent_profile,
+                :status, :error, :updated_at
 
-    def initialize(client, config , working_dir: , ui: , profile: )
+    def permission_mode = @config&.permission_mode&.to_s || ""
+
+    def initialize(client, config, working_dir:, ui:, profile:, session_id:)
       @client = client  # Client for current model
       @config = config.is_a?(AgentConfig) ? config : AgentConfig.new(config)
       @agent_profile = AgentProfile.load(profile)
       @tool_registry = ToolRegistry.new
       @hooks = HookManager.new
-      @session_id = SecureRandom.uuid
+      @session_id = session_id
+      @name = ""
       @messages = []
       @todos = []  # Store todos in memory
       @iterations = 0
@@ -92,7 +96,8 @@ module Clacky
     # Restore from a saved session
     def self.from_session(client, config, session_data, ui: nil, profile:)
       working_dir = session_data[:working_dir] || session_data["working_dir"] || Dir.pwd
-      agent = new(client, config, working_dir: working_dir, ui: ui, profile: profile)
+      original_id = session_data[:session_id] || session_data["session_id"] || Clacky::SessionManager.generate_id
+      agent = new(client, config, working_dir: working_dir, ui: ui, profile: profile, session_id: original_id)
       agent.restore_session(session_data)
       agent
     end
@@ -141,6 +146,11 @@ module Clacky
       @config.model_name
     end
 
+    # Rename this session. Called by auto-naming (first message) or user explicit rename.
+    def rename(new_name)
+      @name = new_name.to_s.strip
+    end
+
     def run(user_input, images: [], files: [])
       # Start new task for Time Machine
       task_id = start_new_task
@@ -210,11 +220,14 @@ module Clacky
           if response[:finish_reason] == "stop" || response[:tool_calls].nil? || response[:tool_calls].empty?
             # During memory update phase, show LLM response as info (not a chat bubble)
             if @memory_updating && response[:content] && !response[:content].empty?
-              @ui&.show_info("🧠 " + response[:content].strip)
+              @ui&.show_info(response[:content].strip)
             elsif response[:content] && !response[:content].empty?
               @ui&.show_assistant_message(response[:content])
             end
 
+            # Show token usage after the assistant message so WebUI renders it below the bubble
+            @ui&.show_token_usage(response[:token_usage]) if response[:token_usage]
+
             # 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"
@@ -237,6 +250,10 @@ module Clacky
             @ui&.show_assistant_message(response[:content])
           end
 
+          # Show token usage after assistant message (or immediately if no message).
+          # This ensures WebUI renders the token line below the assistant bubble.
+          @ui&.show_token_usage(response[:token_usage]) if response[:token_usage]
+
           # Act: Execute tool calls
           action_result = act(response[:tool_calls])
 
@@ -404,6 +421,8 @@ module Clacky
       if response[:tool_calls]&.any?
         msg[:tool_calls] = format_tool_calls_for_api(response[:tool_calls])
       end
+      # Store token_usage in the message so replay_history can re-emit it
+      msg[:token_usage] = response[:token_usage] if response[:token_usage]
       @messages << msg
 
       response
@@ -668,7 +687,7 @@ module Clacky
       @tool_registry.register(Tools::WebSearch.new)
       @tool_registry.register(Tools::WebFetch.new)
       @tool_registry.register(Tools::TodoManager.new)
-      @tool_registry.register(Tools::RunProject.new)
+      # @tool_registry.register(Tools::RunProject.new) # temporarily disabled
       @tool_registry.register(Tools::RequestUserFeedback.new)
       @tool_registry.register(Tools::InvokeSkill.new)
       @tool_registry.register(Tools::UndoTask.new)
@@ -717,12 +736,14 @@ module Clacky
       )
 
       # Create subagent (reuses all tools from parent, inherits agent profile from parent)
+      # Subagent gets its own unique session_id.
       subagent = self.class.new(
         subagent_client,
         subagent_config,
         working_dir: @working_dir,
         ui: @ui,
-        profile: @agent_profile.name
+        profile: @agent_profile.name,
+        session_id: Clacky::SessionManager.generate_id
       )
       subagent.instance_variable_set(:@is_subagent, true)
 

data/lib/clacky/cli.rb

@@ -102,7 +102,8 @@ module Clacky
       end
 
       # Create new agent if no session loaded
-      agent ||= Clacky::Agent.new(client, agent_config, working_dir: working_dir, ui: nil, profile: agent_profile)
+      agent ||= Clacky::Agent.new(client, agent_config, working_dir: working_dir, ui: nil, profile: agent_profile,
+                                   session_id: Clacky::SessionManager.generate_id)
 
       # Change to working directory
       original_dir = Dir.pwd
@@ -358,11 +359,11 @@ module Clacky
           session_id = session[:session_id][0..7]
           tasks = session.dig(:stats, :total_tasks) || 0
           cost = session.dig(:stats, :total_cost_usd) || 0.0
-          last_msg = session[:last_user_message] || "No message"
+          name = session[:name].to_s.empty? ? "Unnamed session" : session[:name]
           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)}) - #{last_msg}", :cyan
+          say "#{dir_marker} #{index + 1}. [#{session_id}] #{created_at} (#{tasks} tasks, $#{cost.round(4)}) - #{name}", :cyan
         end
         say "\n\n💡 Use `clacky -a <session_id>` to resume a session.", :yellow
         say ""
@@ -413,8 +414,8 @@ module Clacky
             matching_sessions.each_with_index do |session, idx|
               created_at = Time.parse(session[:created_at]).strftime("%Y-%m-%d %H:%M")
               session_id = session[:session_id][0..7]
-              last_msg = session[:last_user_message] || "No message"
-              say "  #{idx + 1}. [#{session_id}] #{created_at} - #{last_msg}", :cyan
+              name = session[:name].to_s.empty? ? "Unnamed session" : session[:name]
+              say "  #{idx + 1}. [#{session_id}] #{created_at} - #{name}", :cyan
             end
             say "\nPlease use a more specific prefix.", :yellow
             exit 1
@@ -514,7 +515,8 @@ module Clacky
             when "/exit", "/quit"
               break
             when "/clear"
-              agent = Clacky::Agent.new(client, agent_config, working_dir: working_dir, ui: nil, profile: profile)
+              agent = Clacky::Agent.new(client, agent_config, working_dir: working_dir, ui: nil, profile: profile,
+                                        session_id: Clacky::SessionManager.generate_id)
               agent.instance_variable_set(:@ui, json_ui)
               json_ui.emit("info", message: "Session cleared. Starting fresh.")
               next
@@ -584,9 +586,19 @@ module Clacky
         ui_controller.set_skill_loader(agent.skill_loader, agent.agent_profile)
 
         # Track current working thread (agent or idle compression that can be interrupted)
-        # idle_timer is tracked separately because it should not be interrupted during sleep
         current_task_thread = nil
-        idle_timer_thread = nil
+
+        # Idle compression timer - triggers compression after 180s of inactivity
+        idle_timer = Clacky::IdleCompressionTimer.new(
+          agent:           agent,
+          session_manager: session_manager,
+          logger:          ->(msg, level:) { ui_controller.log(msg, level: level) }
+        ) do |success|
+          if success
+            ui_controller.update_sessionbar(tasks: agent.total_tasks, cost: agent.total_cost)
+          end
+          ui_controller.set_idle_status
+        end
 
         # Set up mode toggle handler
         ui_controller.on_mode_toggle do |new_mode|
@@ -647,7 +659,7 @@ module Clacky
             # Clear output area
             ui_controller.layout.clear_output
             # Clear session by creating a new agent
-            agent = Clacky::Agent.new(client, agent_config, working_dir: working_dir, ui: ui_controller, profile: agent.agent_profile.name)
+            agent = Clacky::Agent.new(client, agent_config, working_dir: working_dir, ui: ui_controller, profile: agent.agent_profile.name, session_id: Clacky::SessionManager.generate_id)
             ui_controller.show_info("Session cleared. Starting fresh.")
             # Update session bar with reset values
             ui_controller.update_sessionbar(tasks: agent.total_tasks, cost: agent.total_cost)
@@ -671,59 +683,7 @@ module Clacky
           end
 
           # Cancel idle timer if running (new input means user is active)
-          if idle_timer_thread&.alive?
-            # ui_controller.log("Idle timer killed, start new 1", level: :debug)
-            idle_timer_thread.kill
-            idle_timer_thread = nil
-          end
-
-          # Helper method to start idle timer after agent completes
-          start_idle_timer = lambda do
-            # Cancel any existing idle timer first
-            if idle_timer_thread&.alive?
-              # ui_controller.log("Idle timer killed, start new 2", level: :debug)
-              idle_timer_thread.kill
-              idle_timer_thread = nil
-            end
-
-            # Start idle timer - trigger compression after 180 seconds of inactivity
-            idle_timer_thread = Thread.new do
-              # ui_controller.log("Idle timer started, will trigger compression in 180 seconds", level: :debug)
-              # Sleep outside of rescue block - if interrupted here, let it propagate and exit
-              sleep 180
-              # ui_controller.log("Idle timer sleep completed, starting compression", level: :debug)
-
-              # After sleep completes, switch to current_task_thread for compression
-              # (so it can be interrupted by Ctrl+C)
-              current_task_thread = Thread.new do
-                begin
-                  # After 60 seconds, start idle compression
-                  ui_controller.set_working_status
-                  success = agent.trigger_idle_compression
-
-                  if success
-                    # Update session bar after compression
-                    ui_controller.update_sessionbar(tasks: agent.total_tasks, cost: agent.total_cost)
-                    # Save session after compression
-                    session_manager&.save(agent.to_session_data(status: :success))
-                  end
-                rescue Clacky::AgentInterrupted
-                  # Compression was interrupted by user
-                  ui_controller.append_output("")
-                  ui_controller.show_info("Idle compression cancelled")
-                rescue => e
-                  ui_controller.log("Idle compression error: #{e.message}", level: :error)
-                ensure
-                  ui_controller.set_idle_status
-                  current_task_thread = nil
-                end
-              end
-
-              # Wait for compression to complete
-              current_task_thread.join
-              idle_timer_thread = nil
-            end
-          end
+          idle_timer.cancel
 
           # Run agent in background thread
           current_task_thread = Thread.new do
@@ -747,7 +707,7 @@ module Clacky
             ensure
               current_task_thread = nil
               # Start idle timer after agent completes
-              start_idle_timer.call
+              idle_timer.start
             end
           end
         end
@@ -765,7 +725,8 @@ module Clacky
         # Start input loop (blocks until exit)
         ui_controller.start_input_loop
 
-        # Cleanup: kill any running thread
+        # Cleanup: kill any running threads
+        idle_timer.cancel
         current_task_thread&.kill
 
         # Save final session state

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

@@ -38,35 +38,39 @@ Example (Chinese):
 > 嗨！我是你的专属 AI 助手 ⚡
 > 只需 30 秒完成个性化设置，我会问你两个简单问题。
 
-### 2. Ask the user's name (card)
+### 2. Ask the user to name the AI (card)
 
-Call `request_user_feedback` to get the user's preferred name.
+Call `request_user_feedback` to let the user pick or type a name for their AI assistant.
+Offer a few fun suggestions as options, plus a free-text fallback.
 
 If `lang == "zh"`, use:
 ```json
 {
-  "question": "先告诉我，我该怎么称呼你？"
+  "question": "先来点有意思的 —— 你想叫我什么名字？可以选一个，也可以直接输入你喜欢的：",
+  "options": ["🐟 摸鱼王", "📚 卷王", "🌟 小天才", "🐱 本喵", "🌅 拾光", "自己输入名字…"]
 }
 ```
 
 Otherwise (English):
 ```json
 {
-  "question": "First, what should I call you?"
+  "question": "Let's start with something fun — what would you like to call me? Pick one or type your own:",
+  "options": ["✨ Aria", "🤖 Max", "🌙 Luna", "⚡ Zap", "🎯 Ace", "Type your own name…"]
 }
 ```
 
-Store the reply as `user.name` (default `"there"` for English, `"朋友"` for Chinese if blank).
+If the user selects the last option or types a custom name, use that as-is. If they chose from the list, strip any emoji prefix.
+Store the result as `ai.name` (default `"Clacky"` if blank).
 
 ### 3. Collect AI personality (card)
 
 Call `request_user_feedback` with a card to set the assistant's personality.
-Address the user by `user.name` in the question.
+Address the AI by `ai.name` in the question.
 
 If `lang == "zh"`, use:
 ```json
 {
-  "question": "好的，[user.name]！来设置一下你的助手吧。",
+  "question": "好的！[ai.name] 应该是什么风格呢？",
   "options": [
     "🎯 专业型 — 精准、结构化、不废话",
     "😊 友好型 — 热情、鼓励、像一位博学的朋友",
@@ -79,7 +83,7 @@ If `lang == "zh"`, use:
 Otherwise (English):
 ```json
 {
-  "question": "Nice to meet you, [user.name]! Now let's set up your assistant.",
+  "question": "Great! What personality should [ai.name] have?",
   "options": [
     "🎯 Professional — Precise, structured, minimal filler",
     "😊 Friendly — Warm, encouraging, like a knowledgeable friend",
@@ -99,12 +103,12 @@ Store: `ai.personality`.
 
 ### 4. Collect user profile (card)
 
-Call `request_user_feedback` again.
+Call `request_user_feedback` again. This is where we learn about the user themselves.
 
 If `lang == "zh"`, use:
 ```json
 {
-  "question": "再简单了解一下你自己吧 —— 全部可选，随便填：\n• 职业\n• 最希望用 AI 做什么\n• 社交 / 作品链接（GitHub、微博、个人网站等）—— AI 会读取公开信息来了解你",
+  "question": "那你呢？随便聊聊自己吧 —— 全部可选，填多少都行：\n• 你的名字（我该怎么称呼你？）\n• 职业\n• 最希望用 AI 做什么\n• 社交 / 作品链接（GitHub、微博、个人网站等）—— 我会读取公开信息来更了解你",
   "options": []
 }
 ```
@@ -112,12 +116,13 @@ If `lang == "zh"`, use:
 Otherwise (English):
 ```json
 {
-  "question": "Now a bit about you — all optional, skip anything you like.\n• Occupation\n• What you want to use AI for most\n• Social / portfolio links (GitHub, Twitter/X, personal site…) — AI will read them to learn about you",
+  "question": "Now a bit about you — all optional, skip anything you like.\n• Your name (what should I call you?)\n• Occupation\n• What you want to use AI for most\n• Social / portfolio links (GitHub, Twitter/X, personal site…) — I'll read them to learn about you",
   "options": []
 }
 ```
 
 Parse the user's reply as free text; extract whatever they provide.
+Store the user's name as `user.name` (default `"老大"` for Chinese, `"Boss"` for English if blank).
 
 ### 5. Learn from links (if any)
 

data/lib/clacky/default_skills/skill-creator/SKILL.md

@@ -28,7 +28,7 @@ Always be flexible. If the user says "skip the evals, just vibe with me", do tha
 
 This skill runs inside **Clacky** (openclacky). Key platform specifics:
 
-- **Skills** live at `~/.clacky/skills/<skill-name>/` — **always create new skills here** (global user skills, visible to Web UI and all sessions)
+- **Skills** live at `~/.clacky/skills/<skill-name>/` — **always create new skills here** (global user skills, visible to Web UI and all sessions). To locate an existing skill, check these paths in order using `glob` or `ls`: (1) `.clacky/skills/` — project-level skills, (2) `~/.clacky/skills/` — user-level skills. Built-in skills (shipped with the gem) are always available via `invoke_skill` by name — no file lookup needed. Never use `find /` or broad filesystem searches to locate skills.
 - **No parallel subagents** — Clacky runs as a single agent; all test cases execute serially in the current session
 - **No external agent CLI** — for evals, just execute the task directly in-session (read the skill, follow instructions, save outputs)
 - **Scripts** — prefer **Ruby** (`.rb` files); Clacky is Ruby-native. Run with `ruby path/to/script.rb`. Python is available but Ruby is the default choice