snow-ai 0.3.25 → 0.3.27

package/dist/api/systemPrompt.js

@@ -75,6 +75,12 @@ const SYSTEM_PROMPT_TEMPLATE = `You are Snow AI CLI, an intelligent command-line
 
 ## 🚀 Execution Strategy - BALANCE ACTION & ANALYSIS
 
+## 🤖 Rigorous coding habits
+- In any programming language or business logic, which is usually accompanied by many-to-many references to files, you also need to think about the impact of the modification and whether it will conflict with the user's original business.
+- Using the optimal solution principle, you cannot choose risk scenarios such as hardcoding, logic simplification, etc., unless the user asks you to do so.
+- Avoid duplication, users may have encapsulated some reusable functions, and you should try to find them instead of creating a new function right away.
+- Compilable principle, you should not have low-level errors such as syntax errors, use tools to check for syntax errors, non-compilable code is meaningless.
+
 ### ⚡ Smart Action Mode
 **Principle: Understand enough to code correctly, but don't over-investigate**
 
@@ -95,38 +101,50 @@ const SYSTEM_PROMPT_TEMPLATE = `You are Snow AI CLI, an intelligent command-line
 
 **Golden Rule: Read what you need to write correct code, nothing more.**
 
-### 📋 TODO Lists - Essential for Programming Tasks
-
-**✅ ALWAYS CREATE TODO WHEN encountering programming tasks:**
-- Any code implementation task (new features, bug fixes, refactoring)
-- Tasks involving multiple steps or files
-- When you need to track progress and ensure completion
-- To give users clear visibility into your work plan
-
-**TODO Guidelines:**
-1. **Create Early**: Set up TODO list BEFORE starting implementation
-2. **Be Specific**: Each item should be a concrete action
-3. **Update Immediately**: Mark as completed immediately after finishing each task
-4. **Focus on Completion**: Move from pending to completed, no intermediate states
-
-**TODO = Action List, NOT Investigation Plan**
-- ✅ "Create AuthService with login/logout methods"
-- ✅ "Add validation to UserForm component"
-- ✅ "Fix timeout bug in parser.ts"
-- ✅ "Update API routes to use new auth middleware"
-- ✅ "Run build and fix any errors"
-- ❌ "Read authentication files"
-- ❌ "Analyze current implementation"
-- ❌ "Investigate error handling patterns"
-
-**CRITICAL: Update TODO status IMMEDIATELY after completing each task!**
-
-**Workflow Example:**
-1. User asks to add feature → Create TODO list immediately
-2. Complete the first task → Mark as completed
-3. Move to next task → Complete and mark as completed
-4. Repeat until all tasks completed
-5. Focus on getting tasks done rather than tracking intermediate states
+### 📋 TODO Management - STRONGLY RECOMMENDED for Better Results!
+
+**🎯 DEFAULT BEHAVIOR: Use TODO for ALL multi-step tasks (3+ steps)**
+
+**✨ WHY TODO IS ESSENTIAL:**
+- 📊 **Track progress** - Never lose your place in complex work
+- ✅ **Ensure completeness** - Verify all steps are done
+- 🎯 **Stay focused** - Clear roadmap prevents confusion
+- 💪 **Build confidence** - Users see structured progress
+- 🚀 **Better quality** - Systematic approach reduces errors
+
+**⚡ WHEN TO USE TODO (Default for most tasks):**
+- ✅ **ANY multi-file modification** (always use)
+- ✅ **ANY feature implementation** (always use)
+- ✅ **ANY refactoring task** (always use)
+- ✅ **Bug fixes touching 2+ files** (recommended)
+- ✅ **User requests with multiple requirements** (always use)
+- ✅ **Unfamiliar codebase changes** (recommended)
+- ⚠️ **SKIP ONLY for**: Single-file trivial edits (1-2 lines)
+
+**🔧 USAGE RULES (Critical):**
+1. **⚠️ PARALLEL CALLS ONLY**: ALWAYS call TODO tools with action tools in the SAME function call block
+2. **Immediate updates**: Mark completed while performing work (not after)
+3. **Right sizing**: 3-7 main tasks, add subtasks if needed
+4. **Lifecycle Management**:
+   - New task = Create TODO at start
+   - Major requirement change = Delete old + create new
+   - Minor adjustment = Use todo-add or todo-update
+   - **CRITICAL**: Keep using TODO throughout the entire conversation!
+
+**✅ CORRECT PATTERNS (Do this):**
+- ✅ todo-create + filesystem-read → Plan while gathering info
+- ✅ todo-update(completed) + filesystem-edit → Update as you work
+- ✅ todo-get + filesystem-read → Check status while reading
+- ✅ todo-add + filesystem-edit → Add new task while working
+
+**❌ FORBIDDEN PATTERNS (NEVER do this - WILL FAIL):**
+- ❌ todo-create alone, wait for result, then work → VIOLATION! Call together!
+- ❌ todo-update alone, wait, then continue → VIOLATION! Update while working!
+- ❌ todo-get alone just to check → VIOLATION! Call with other tools!
+- ❌ Skipping TODO for multi-file tasks → VIOLATION! Always use TODO!
+- ❌ **Abandoning TODO mid-conversation** → VIOLATION! Keep using throughout dialogue!
+
+**💡 BEST PRACTICE: Start every non-trivial task with todo-create + initial action in parallel!**
 
 ## 🛠️ Available Tools
 

package/dist/hooks/useCommandHandler.d.ts

@@ -19,6 +19,7 @@ type CommandHandlerOptions = {
     setShowMcpInfo: React.Dispatch<React.SetStateAction<boolean>>;
     setShowMcpPanel: React.Dispatch<React.SetStateAction<boolean>>;
     setShowUsagePanel: React.Dispatch<React.SetStateAction<boolean>>;
+    setShowHelpPanel: React.Dispatch<React.SetStateAction<boolean>>;
     setMcpPanelKey: React.Dispatch<React.SetStateAction<number>>;
     setYoloMode: React.Dispatch<React.SetStateAction<boolean>>;
     setContextUsage: React.Dispatch<React.SetStateAction<UsageInfo | null>>;

package/dist/hooks/useCommandHandler.js

@@ -45,7 +45,8 @@ export async function executeContextCompression() {
             timestamp: Date.now(),
         });
         // 添加保留的最后一轮完整对话（保留完整的消息结构）
-        if (compressionResult.preservedMessages && compressionResult.preservedMessages.length > 0) {
+        if (compressionResult.preservedMessages &&
+            compressionResult.preservedMessages.length > 0) {
             for (const msg of compressionResult.preservedMessages) {
                 // 保留完整的消息结构，包括所有关键字段
                 newSessionMessages.push({
@@ -56,7 +57,9 @@ export async function executeContextCompression() {
                     ...(msg.tool_calls && { tool_calls: msg.tool_calls }),
                     ...(msg.images && { images: msg.images }),
                     ...(msg.reasoning && { reasoning: msg.reasoning }),
-                    ...(msg.subAgentInternal !== undefined && { subAgentInternal: msg.subAgentInternal }),
+                    ...(msg.subAgentInternal !== undefined && {
+                        subAgentInternal: msg.subAgentInternal,
+                    }),
                 });
             }
         }
@@ -220,6 +223,15 @@ export function useCommandHandler(options) {
             };
             options.setMessages(prev => [...prev, commandMessage]);
         }
+        else if (result.success && result.action === 'showHelpPanel') {
+            options.setShowHelpPanel(true);
+            const commandMessage = {
+                role: 'command',
+                content: '',
+                commandName: commandName,
+            };
+            options.setMessages(prev => [...prev, commandMessage]);
+        }
         else if (result.success && result.action === 'home') {
             // Reset terminal before navigating to welcome screen
             resetTerminal(stdout);
@@ -284,7 +296,10 @@ export function useCommandHandler(options) {
                     return;
                 }
                 // Generate default filename with timestamp
-                const timestamp = new Date().toISOString().replace(/[:.]/g, '-').split('.')[0];
+                const timestamp = new Date()
+                    .toISOString()
+                    .replace(/[:.]/g, '-')
+                    .split('.')[0];
                 const defaultFilename = `snow-chat-${timestamp}.txt`;
                 // Show native save dialog
                 const filePath = await showSaveDialog(defaultFilename, 'Export Chat Conversation');

package/dist/hooks/useCommandPanel.js

@@ -1,6 +1,7 @@
 import { useState, useCallback } from 'react';
 // Command Definition
 const commands = [
+    { name: 'help', description: 'Show keyboard shortcuts and help information' },
     { name: 'clear', description: 'Clear chat context and conversation history' },
     { name: 'resume', description: 'Resume a conversation' },
     { name: 'mcp', description: 'Show Model Context Protocol services and tools' },
@@ -52,8 +53,40 @@ export function useCommandPanel(buffer, isProcessing = false) {
         if (!text.startsWith('/'))
             return [];
         const query = text.slice(1).toLowerCase();
-        return commands.filter(command => command.name.toLowerCase().includes(query) ||
-            command.description.toLowerCase().includes(query));
+        // Filter and sort commands by priority
+        // Priority order:
+        // 1. Command starts with query (highest)
+        // 2. Command contains query
+        // 3. Description starts with query
+        // 4. Description contains query (lowest)
+        const filtered = commands
+            .filter(command => command.name.toLowerCase().includes(query) ||
+            command.description.toLowerCase().includes(query))
+            .map(command => {
+            const nameLower = command.name.toLowerCase();
+            const descLower = command.description.toLowerCase();
+            let priority = 4; // Default: description contains query
+            if (nameLower.startsWith(query)) {
+                priority = 1; // Command starts with query
+            }
+            else if (nameLower.includes(query)) {
+                priority = 2; // Command contains query
+            }
+            else if (descLower.startsWith(query)) {
+                priority = 3; // Description starts with query
+            }
+            return { command, priority };
+        })
+            .sort((a, b) => {
+            // Sort by priority (lower number = higher priority)
+            if (a.priority !== b.priority) {
+                return a.priority - b.priority;
+            }
+            // If same priority, sort alphabetically by name
+            return a.command.name.localeCompare(b.command.name);
+        })
+            .map(item => item.command);
+        return filtered;
     }, [buffer]);
     // Update command panel state
     const updateCommandPanelState = useCallback((text) => {

package/dist/mcp/todo.js

@@ -213,36 +213,43 @@ export class TodoService {
         return [
             {
                 name: 'todo-create',
-                description: `Create a TODO list for complex multi-step tasks (optional planning tool).
+                description: `✅ RECOMMENDED: Create TODO list for structured task execution. Use this for ALL multi-step tasks!
 
-## CORE PRINCIPLE - FOCUS ON EXECUTION:
-TODO lists are OPTIONAL helpers for complex tasks. Your PRIMARY goal is COMPLETING THE WORK, not maintaining perfect TODO lists. Use this tool only when it genuinely helps organize complex work - don't let TODO management slow you down.
+⚠️ MANDATORY RULE - PARALLEL CALLS ONLY:
+🚫 NEVER call todo-create alone! MUST call with other tools in the SAME function call block.
+✅ ALWAYS: todo-create + filesystem-read (or other action tool) in parallel
+❌ FORBIDDEN: Call todo-create, wait for result, then call other tools
 
-## WHEN TO USE (Optional):
-- Complex tasks with 5+ distinct steps that benefit from tracking
-- Long-running tasks where progress visibility helps the user
-- Tasks with multiple dependencies that need careful ordering
-- User explicitly requests a TODO list
+## 🎯 DEFAULT USAGE - Use TODO by default for:
+✅ ANY multi-file changes (always create TODO first)
+✅ ANY feature implementation (plan with TODO)
+✅ ANY refactoring work (track with TODO)
+✅ Bug fixes involving 2+ files (use TODO)
+✅ Tasks with 3+ distinct steps (create TODO)
+⚠️ SKIP ONLY: Single-file trivial edits (1-2 lines)
 
-## WHEN TO SKIP:
-- Simple 1-3 step tasks (just do the work directly)
-- Straightforward file edits or single-function changes
-- Quick fixes or minor modifications
-- When TODO creation takes longer than just doing the task
+## 🚀 WHY CREATE TODO:
+- Ensures all requirements are addressed
+- Prevents missing critical steps
+- Provides clear progress tracking
+- Improves code quality through systematic approach
+- Builds user confidence with visible structure
 
-## LIFECYCLE MANAGEMENT:
-1. **NEW REQUEST = NEW TODO LIST**: Completely new requirement? Delete old todos first, then create new list.
-2. **INCREMENTAL REQUEST = USE TODO-ADD**: Adding to existing requirement? Use "todo-add" instead.
-3. Use this tool ONLY when starting fresh (new session or new requirement after cleanup).
+## 📋 WHEN TO CALL:
+1. **NEW TASK**: Create TODO immediately when starting work (with parallel action)
+2. **NEW REQUIREMENT**: Delete old todos, create fresh list (with parallel action)
+3. **BEST PRACTICE**: Call todo-create + filesystem-read in parallel
 
-## CREATION GUIDELINES:
-- Keep it simple and actionable
-- 3-7 main tasks is usually sufficient (don't over-plan)
-- Include verification steps only if critical
-- Order by dependencies
+## ⚡ CREATION GUIDELINES:
+- Break work into 3-7 clear, actionable tasks
+- Order by logical dependencies
+- Be specific (e.g., "Modify validateInput in form.ts" not "fix validation")
+- Include verification step if critical
 
-## WARNING:
-This REPLACES the entire TODO list. Never use it to "add more tasks" - use "todo-add" instead.`,
+## ⚠️ LIFECYCLE:
+This REPLACES the entire TODO list. For adding tasks to existing list, use "todo-add" instead.
+
+## 💡 REMEMBER: MUST call with other tools - never alone!`,
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -270,15 +277,19 @@ This REPLACES the entire TODO list. Never use it to "add more tasks" - use "todo
             },
             {
                 name: 'todo-get',
-                description: `Get the current TODO list for this session.
+                description: `Get current TODO list with task IDs, status, and hierarchy.
+
+⚠️ MANDATORY RULE - PARALLEL CALLS ONLY:
+🚫 NEVER call todo-get alone! MUST call with other tools in the SAME function call block.
+✅ ALWAYS: todo-get + filesystem-read/terminal-execute/etc in parallel
+❌ FORBIDDEN: Call todo-get alone to check status
 
-## WHEN TO USE:
-- Before making any updates to check current task status and IDs
-- To verify what tasks exist before deciding to add/delete/update
-- To inspect the TODO structure before planning next steps
+## 🔄 WHEN TO USE IN DIALOGUE:
+- **User provides additional info**: Use todo-get + filesystem-read to check what's done
+- **User requests modifications**: Check current progress before adding/updating tasks
+- **Continuing work**: Always check status first to avoid redoing completed tasks
 
-## RETURNS:
-Complete TODO list with all task IDs, content, status, and hierarchy.`,
+USAGE: Combine with filesystem-read, terminal-execute, or other actions to check progress while working.`,
                 inputSchema: {
                     type: 'object',
                     properties: {},
@@ -286,26 +297,17 @@ Complete TODO list with all task IDs, content, status, and hierarchy.`,
             },
             {
                 name: 'todo-update',
-                description: `Update TODO status or content - USE ONLY WHEN COMPLETING TASKS.
-
-## CORE PRINCIPLE - WORK FIRST, completed in an orderly manner:
-
-## STATUS MODEL:
-- **pending**: Task not yet completed (default)
-- **completed**: Task is 100% finished and verified
+                description: `Update TODO status/content - USE THIS FREQUENTLY to track progress!
 
-## WHEN TO UPDATE:
-✅ **Mark "completed"** ONLY when:
-  - When completing a task in the List
-  - No errors or blockers
-  - You've actually verified it works
+⚠️ MANDATORY RULE - PARALLEL CALLS ONLY:
+🚫 NEVER call todo-update alone! MUST call with other tools in the SAME function call block.
+✅ ALWAYS: todo-update + filesystem-edit/terminal-execute/etc in parallel
+❌ FORBIDDEN: Call todo-update, wait for result, then proceed
 
-## WHEN NOT TO UPDATE:
-❌ Don't update status to track "in progress" - just do the work
-❌ Don't update before verifying the work is complete
+BEST PRACTICE: Mark "completed" ONLY after task is verified.
+Example: todo-update(task1, completed) + filesystem-edit(task2) → Update while working!
 
-## BEST PRACTICE:
-Every time you complete a task in Task, it will be updated to "Completed" immediately.`,
+💡 This ensures efficient workflow and prevents unnecessary wait times.`,
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -328,24 +330,19 @@ Every time you complete a task in Task, it will be updated to "Completed" immedi
             },
             {
                 name: 'todo-add',
-                description: `Add tasks to existing TODO list (use sparingly).
+                description: `Add new task to existing TODO list when requirements expand.
 
-## CORE PRINCIPLE - AVOID TODO BLOAT:
-Don't constantly add TODO items while working. If you discover small steps during execution, JUST DO THEM instead of creating TODO items. Only add to TODO if it's genuinely complex or user-requested.
+⚠️ MANDATORY RULE - PARALLEL CALLS ONLY:
+🚫 NEVER call todo-add alone! MUST call with other tools in the SAME function call block.
+✅ ALWAYS: todo-add + filesystem-edit/filesystem-read/etc in parallel
+❌ FORBIDDEN: Call todo-add alone to add task
 
-## WHEN TO USE (Rare):
-1. **User Adds Requirements**: User explicitly requests additional tasks
-2. **Major Discovery**: You find a significant, complex step that wasn't initially planned
-3. **Blocking Issue**: You discover a prerequisite that requires substantial separate work
+USE WHEN:
+- User adds new requirements during work
+- You discover additional necessary steps
+- Breaking down a complex task into subtasks
 
-## WHEN NOT TO USE (Common):
-- ❌ Discovered a small 5-minute task while working (just do it, don't track it)
-- ❌ Breaking down an existing task into micro-steps (over-planning)
-- ❌ "Organizing" or "clarifying" existing tasks (maintain original structure)
-- ❌ New unrelated requirement (use todo-delete + todo-create instead)
-
-## GUIDELINE:
-If a task takes less than 10 minutes, just do it instead of adding it to TODO. The goal is progress, not perfect tracking.`,
+DO NOT use for initial planning - use todo-create instead.`,
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -363,27 +360,14 @@ If a task takes less than 10 minutes, just do it instead of adding it to TODO. T
             },
             {
                 name: 'todo-delete',
-                description: `Delete TODO items from the current session.
-
-## WHEN TO USE:
-1. **Task No Longer Needed**: Requirement changed, task became irrelevant
-2. **Mistake Correction**: Task was added by error or duplicated
-3. **Clearing for New Requirement**: User provides COMPLETELY NEW requirement - delete all old todos first, then create new list
-4. **Cascade Deletion**: Delete parent task with subtasks (automatically removes children)
-
-## LIFECYCLE PATTERN FOR NEW REQUIREMENTS:
-When user asks for something completely different:
-1. Use todo-get to see current list
-2. Use todo-delete on root items (children auto-delete via parentId cascade)
-3. Use todo-create for the new requirement
+                description: `Delete TODO item from the list.
 
-## WHEN NOT TO USE:
-- Do NOT delete completed tasks just for "cleanup" (keep as history)
-- Do NOT delete in-progress tasks unless requirement truly changed
-- Do NOT use for "reorganizing" (maintain original structure)
+⚠️ MANDATORY RULE - PARALLEL CALLS ONLY:
+🚫 NEVER call todo-delete alone! MUST call with other tools in the SAME function call block.
+✅ ALWAYS: todo-delete + filesystem-edit/todo-get/etc in parallel
+❌ FORBIDDEN: Call todo-delete alone
 
-## CASCADE BEHAVIOR:
-Deleting a parent task automatically deletes all its subtasks (parentId relationship).`,
+NOTE: Deleting a parent task will cascade delete all its children automatically.`,
                 inputSchema: {
                     type: 'object',
                     properties: {

package/dist/ui/components/ChatInput.js

@@ -354,15 +354,13 @@ export default function ChatInput({ onSubmit, onCommand, placeholder = 'Type you
                                 ' ',
                                 "cached"))))));
                 })()))),
-            React.createElement(Box, { marginTop: 1 },
+            (showCommands && getFilteredCommands().length > 0) ||
+                showFilePicker ? (React.createElement(Box, { marginTop: 1 },
                 React.createElement(Text, null, showCommands && getFilteredCommands().length > 0
                     ? 'Type to filter commands'
                     : showFilePicker
                         ? searchMode === 'content'
                             ? 'Content search • Tab/Enter to select • ESC to cancel'
                             : 'Type to filter files • Tab/Enter to select • ESC to cancel'
-                        : (() => {
-                            const pasteKey = process.platform === 'darwin' ? 'Ctrl+V' : 'Alt+V';
-                            return `Ctrl+L: delete to start • Ctrl+R: delete to end • ${pasteKey}: paste images • '@': files • '@@': search content • '/': commands`;
-                        })()))))));
+                        : ''))) : null))));
 }

package/dist/ui/components/HelpPanel.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export default function HelpPanel(): React.JSX.Element;

package/dist/ui/components/HelpPanel.js

@@ -0,0 +1,38 @@
+import React from 'react';
+import { Box, Text } from 'ink';
+// Get platform-specific paste key
+const getPasteKey = () => {
+    return process.platform === 'darwin' ? 'Ctrl+V' : 'Alt+V';
+};
+export default function HelpPanel() {
+    const pasteKey = getPasteKey();
+    return (React.createElement(Box, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 2, paddingY: 1 },
+        React.createElement(Box, { marginBottom: 1 },
+            React.createElement(Text, { bold: true, color: "cyan" }, "\uD83D\uDD30 Keyboard Shortcuts & Help")),
+        React.createElement(Box, { flexDirection: "column", marginBottom: 1 },
+            React.createElement(Text, { bold: true, color: "yellow" }, "\uD83D\uDCDD Text Editing:"),
+            React.createElement(Text, null, "  \u2022 Ctrl+L - Delete from cursor to start"),
+            React.createElement(Text, null, "  \u2022 Ctrl+R - Delete from cursor to end"),
+            React.createElement(Text, null,
+                "  \u2022 ",
+                pasteKey,
+                " - Paste images from clipboard")),
+        React.createElement(Box, { flexDirection: "column", marginBottom: 1 },
+            React.createElement(Text, { bold: true, color: "green" }, "\uD83D\uDD0D Quick Access:"),
+            React.createElement(Text, null, "  \u2022 @ - Insert files from project"),
+            React.createElement(Text, null, "  \u2022 @@ - Search file content"),
+            React.createElement(Text, null, "  \u2022 / - Show available commands")),
+        React.createElement(Box, { flexDirection: "column", marginBottom: 1 },
+            React.createElement(Text, { bold: true, color: "blue" }, "\uD83D\uDCCB Navigation:"),
+            React.createElement(Text, null, "  \u2022 \u2191/\u2193 - Navigate command/message history"),
+            React.createElement(Text, null, "  \u2022 Tab/Enter - Select item in pickers"),
+            React.createElement(Text, null, "  \u2022 ESC - Cancel/close pickers or interrupt AI response"),
+            React.createElement(Text, null, "  \u2022 Shift+Tab - Toggle YOLO mode (auto-approve tools)")),
+        React.createElement(Box, { flexDirection: "column" },
+            React.createElement(Text, { bold: true, color: "magenta" }, "\uD83D\uDCA1 Tips:"),
+            React.createElement(Text, null, "  \u2022 Use /help anytime to see this information"),
+            React.createElement(Text, null, "  \u2022 Type / to see all available commands"),
+            React.createElement(Text, null, "  \u2022 Press ESC during AI response to interrupt")),
+        React.createElement(Box, { marginTop: 1 },
+            React.createElement(Text, { dimColor: true, color: "gray" }, "Press ESC to close this help panel"))));
+}

package/dist/ui/components/MarkdownRenderer.js

@@ -1,19 +1,23 @@
 import React from 'react';
-import { Text } from 'ink';
+import { Text, Box } from 'ink';
 // @ts-expect-error - cli-markdown doesn't have TypeScript definitions
 import cliMarkdown from 'cli-markdown';
+import logger from '../../utils/logger.js';
 export default function MarkdownRenderer({ content }) {
     // Use cli-markdown for elegant markdown rendering with syntax highlighting
     // The patched highlight function will gracefully handle unknown languages
     const rendered = cliMarkdown(content);
-    // Remove excessive trailing newlines and whitespace from cli-markdown output
-    // Keep single blank lines for paragraph spacing (better readability)
-    const trimmedRendered = rendered
-        .split('\n')
-        .map((line) => line.trimEnd()) // Remove trailing spaces from each line
-        .join('\n')
-        .replace(/\n{3,}/g, '\n\n') // Replace 3+ consecutive newlines with 2 (paragraph spacing)
-        .replace(/^\n+/g, '') // Remove leading newlines
-        .replace(/\n+$/g, ''); // Remove trailing newlines
-    return React.createElement(Text, null, trimmedRendered);
+    // Split into lines and render each separately
+    // This prevents Ink's Text component from creating mysterious whitespace
+    // when handling multi-line content with \n characters
+    const lines = rendered.split('\n');
+    // Safety check: prevent rendering issues with excessively long output
+    if (lines.length > 500) {
+        logger.warn('[MarkdownRenderer] Rendered output has too many lines', {
+            totalLines: lines.length,
+            truncatedTo: 500,
+        });
+        return (React.createElement(Box, { flexDirection: "column" }, lines.slice(0, 500).map((line, index) => (React.createElement(Text, { key: index }, line)))));
+    }
+    return (React.createElement(Box, { flexDirection: "column" }, lines.map((line, index) => (React.createElement(Text, { key: index }, line)))));
 }

package/dist/ui/components/TodoTree.js

@@ -20,9 +20,11 @@ export default function TodoTree({ todos }) {
     const getStatusIcon = (status) => {
         switch (status) {
             case 'completed':
-                return '[x]';
+                return '[✓]';
             case 'pending':
                 return '[ ]';
+            default:
+                return '[ ]';
         }
     };
     const getStatusColor = (status) => {
@@ -52,5 +54,5 @@ export default function TodoTree({ todos }) {
             React.createElement(Text, { bold: true, color: "cyan" }, "TODO List")),
         rootTodos.map(todo => renderTodo(todo)),
         React.createElement(Box, { marginTop: 0 },
-            React.createElement(Text, { dimColor: true, color: "gray" }, "[ ] Pending \u00B7 [x] Completed"))));
+            React.createElement(Text, { dimColor: true, color: "gray" }, "[ ] Pending \u00B7 [\u2713] Completed"))));
 }

package/dist/ui/pages/ChatScreen.d.ts

@@ -13,6 +13,7 @@ import '../../utils/commands/usage.js';
 import '../../utils/commands/export.js';
 import '../../utils/commands/agent.js';
 import '../../utils/commands/todoPicker.js';
+import '../../utils/commands/help.js';
 type Props = {
     skipWelcome?: boolean;
 };

package/dist/ui/pages/ChatScreen.js

@@ -9,6 +9,7 @@ import MCPInfoScreen from '../components/MCPInfoScreen.js';
 import MCPInfoPanel from '../components/MCPInfoPanel.js';
 import SessionListPanel from '../components/SessionListPanel.js';
 import UsagePanel from '../components/UsagePanel.js';
+import HelpPanel from '../components/HelpPanel.js';
 import MarkdownRenderer from '../components/MarkdownRenderer.js';
 import ToolConfirmation from '../components/ToolConfirmation.js';
 import DiffViewer from '../components/DiffViewer.js';
@@ -46,6 +47,7 @@ import '../../utils/commands/usage.js';
 import '../../utils/commands/export.js';
 import '../../utils/commands/agent.js';
 import '../../utils/commands/todoPicker.js';
+import '../../utils/commands/help.js';
 export default function ChatScreen({ skipWelcome }) {
     const [messages, setMessages] = useState([]);
     const [isSaving] = useState(false);
@@ -77,6 +79,7 @@ export default function ChatScreen({ skipWelcome }) {
     const [showSessionPanel, setShowSessionPanel] = useState(false);
     const [showMcpPanel, setShowMcpPanel] = useState(false);
     const [showUsagePanel, setShowUsagePanel] = useState(false);
+    const [showHelpPanel, setShowHelpPanel] = useState(false);
     const [restoreInputContent, setRestoreInputContent] = useState(null);
     const { columns: terminalWidth, rows: terminalHeight } = useTerminalSize();
     const { stdout } = useStdout();
@@ -188,6 +191,7 @@ export default function ChatScreen({ skipWelcome }) {
         setShowMcpInfo,
         setShowMcpPanel,
         setShowUsagePanel,
+        setShowHelpPanel,
         setMcpPanelKey,
         setYoloMode,
         setContextUsage: streamingState.setContextUsage,
@@ -256,6 +260,12 @@ export default function ChatScreen({ skipWelcome }) {
             }
             return;
         }
+        if (showHelpPanel) {
+            if (key.escape) {
+                setShowHelpPanel(false);
+            }
+            return;
+        }
         if (showMcpInfo) {
             if (key.escape) {
                 setShowMcpInfo(false);
@@ -889,7 +899,11 @@ export default function ChatScreen({ skipWelcome }) {
                             React.createElement(Text, null, "\u2022 Ask for code explanations and debugging help"),
                             React.createElement(Text, null, "\u2022 Press ESC during response to interrupt"),
                             React.createElement(Text, null, "\u2022 Press Shift+Tab: toggle YOLO"),
-                            React.createElement(Text, null,
+                            React.createElement(Text, null, (() => {
+                                const pasteKey = process.platform === 'darwin' ? 'Ctrl+V' : 'Alt+V';
+                                return `• Shortcuts: Ctrl+L (delete to start) • Ctrl+R (delete to end) • ${pasteKey} (paste images) • '@' (files) • '@@' (search content) • '/' (commands)`;
+                            })()),
+                            React.createElement(Text, { color: "gray", dimColor: true },
                                 "\u2022 Working directory: ",
                                 workingDirectory)))),
                 ...messages
@@ -1069,12 +1083,15 @@ export default function ChatScreen({ skipWelcome }) {
             React.createElement(UsagePanel, null),
             React.createElement(Box, { marginTop: 1 },
                 React.createElement(Text, { color: "gray", dimColor: true }, "Press ESC to close")))),
+        showHelpPanel && (React.createElement(Box, { paddingX: 1, flexDirection: "column", width: terminalWidth },
+            React.createElement(HelpPanel, null))),
         snapshotState.pendingRollback && (React.createElement(FileRollbackConfirmation, { fileCount: snapshotState.pendingRollback.fileCount, filePaths: snapshotState.pendingRollback.filePaths || [], onConfirm: handleRollbackConfirm })),
         !pendingToolConfirmation &&
             !isCompressing &&
             !showSessionPanel &&
             !showMcpPanel &&
             !showUsagePanel &&
+            !showHelpPanel &&
             !snapshotState.pendingRollback && (React.createElement(React.Fragment, null,
             React.createElement(ChatInput, { onSubmit: handleMessageSubmit, onCommand: handleCommandExecution, placeholder: "Ask me anything about coding...", disabled: !!pendingToolConfirmation, isProcessing: streamingState.isStreaming || isSaving, chatHistory: messages, onHistorySelect: handleHistorySelect, yoloMode: yoloMode, contextUsage: streamingState.contextUsage
                     ? {

package/dist/utils/commandExecutor.d.ts

@@ -1,7 +1,7 @@
 export interface CommandResult {
     success: boolean;
     message?: string;
-    action?: 'clear' | 'resume' | 'info' | 'showMcpInfo' | 'toggleYolo' | 'initProject' | 'compact' | 'showSessionPanel' | 'showMcpPanel' | 'showUsagePanel' | 'home' | 'review' | 'exportChat' | 'showAgentPicker' | 'showTodoPicker';
+    action?: 'clear' | 'resume' | 'info' | 'showMcpInfo' | 'toggleYolo' | 'initProject' | 'compact' | 'showSessionPanel' | 'showMcpPanel' | 'showUsagePanel' | 'home' | 'review' | 'exportChat' | 'showAgentPicker' | 'showTodoPicker' | 'showHelpPanel';
     prompt?: string;
     alreadyConnected?: boolean;
 }

package/dist/utils/commands/help.d.ts

@@ -0,0 +1,2 @@
+declare const _default: {};
+export default _default;

package/dist/utils/commands/help.js

@@ -0,0 +1,11 @@
+import { registerCommand } from '../commandExecutor.js';
+// Help command handler - show keyboard shortcuts and help information
+registerCommand('help', {
+    execute: () => {
+        return {
+            success: true,
+            action: 'showHelpPanel',
+        };
+    },
+});
+export default {};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "snow-ai",
-	"version": "0.3.25",
+	"version": "0.3.27",
 	"description": "Intelligent Command Line Assistant powered by AI",
 	"license": "MIT",
 	"bin": {