Plan Mode
Safe, Read-Only Code Exploration Feature
Plan Mode is a read-only environment that allows you to safely browse, search, and analyze projects without modifying any code, helping you develop clear plans for subsequent development or refactoring.
✅ Suitable for: Taking over new projects, troubleshooting complex logic, research phases before designing change solutions.
Core Features
🔒 Completely Read-Only: Cannot create, edit, or delete files, preventing accidental operations
🔍 Deep Exploration: Supports full-text search, directory browsing, code diff viewing
🧠 Intelligent Assistance: AI helps you understand code and organize logic based on read-only context
⚙️ MCP Tool Compatibility: Can call all MCP tools that support read-only operations
How to Enter Plan Mode?
- Click the mode selector below the chat box and select "Plan"
Typical Workflow
Enter Plan Mode → Safely explore the codebase
Ask Questions & Analyze → "How does this module handle user permissions?"
Develop Solutions → AI helps you organize implementation paths
Switch to Agent Mode → Execute actual modifications
💡 Plan Mode shares the same interface and context features (such as
@Files, code highlighting) with Chat Mode and Agent Mode, providing a seamless experience.
Available Read-Only Tools List
| Function | Description |
|---|---|
read_file | Read specified file content |
read_currently_open_file | Get currently opened file |
ls / view_subdirectory | List directory or subdirectory structure |
glob_search | Search files using wildcards (e.g., *.java) |
grep_search | Full-text search for keywords in code |
view_diff | View uncommitted code changes (git diff) |
view_repo_map | Get overview of project structure |
fetch_url_content / search_web | Get external webpage or API content to aid understanding |
❌ Not supported: Writing files, running commands, executing terminal operations, or any modification behaviors.
🛡️ Tip: When you're unsure how to modify code, use Plan Mode to "scout" first - safe, efficient, zero risk!