Agent Mode And Tools
2 min read
Agent Mode lets SystemSculpt perform vault actions with your approval. Requires Pro license.
Capabilities
- Read and analyze notes
- Create and modify files
- Search your vault
- Organize content
Enabling Agent Mode
Individual Chats: Click tools icon (🛠️), use /agent, or Command Palette
Default Setting: Enable "Default Agent Mode" in AI Chat settings
MCP Tools
File Operations (Write Tools)
- write_file: Create or overwrite files
- edit_file: Precise text replacements
- trash_files: Move to trash (recoverable)
Directory Operations (Write Tools)
- create_directories: Create folders
- move_items: Move/rename items, updates links
Search Operations (Read Tools)
- find_files: Fast filename search, fuzzy matching
- grep_vault: Regex content search
- search_metadata: YAML frontmatter search
- read_files: Read file contents
Management Operations
- manage_workspace: Open files in tabs/panes
- manage_context: Control AI file access
- list_directories: List folder contents
- analyze_vault_storage: Storage usage analysis
Tool Permissions
Configure in Advanced settings → MCP Configuration:
- Toggle individual tools
- Enable auto-approval (caution with write tools)
- Bulk enable/disable options
Safety Features
Approval System: Preview all actions before execution
Tool Categories:
- Read Tools: Information only
- Write Tools: Modify vault
Best Practices: Start with read tools, review before approval
Example Commands
Information: "Show notes created this week", "Find untagged notes"
Creation: "Create daily note", "Add task to todo"
Organization: "Move 2023 notes to Archive", "Find duplicates"
Agent Model: SystemSculpt AI Agent (moonshotai/kimi-k2)
Troubleshooting
- Not available: Check Pro license and MCP settings
- Access denied: Enable Agent Mode and specific tool
- Action failed: Check error, permissions, paths
Context Management
Maintains last 15 results (10KB max each) to prevent overflow.
Next Steps
- Configure permissions in Advanced settings
- Start with read tools
- See Smart Features and Commands