Tools Overview

Complete reference for all Desktop Commander tools and capabilities

Desktop Commander Tools

Desktop Commander provides Claude with a comprehensive set of tools to work with your computer. These tools are organized into categories based on their functionality.

Tool Categories

File Operations

Read, write, edit, and manage individual files with precision

Directory Management

Create, list, and organize directories and folder structures

Search & Discovery

Find files by name or search content across your codebase

Process Management

Run commands, execute code, and manage terminal sessions

System Tools

Configure security, monitor usage, and manage system settings

File Operations

Work with individual files - read content, make changes, and manage file data:

Tool	Purpose	Best For
read_file	Read file contents with optional range selection	Viewing code, documents, logs
write_file	Create new files or completely rewrite existing ones	Creating new files, replacing content
edit_block	Make precise changes to specific parts of files	Code fixes, targeted edits
read_multiple_files	Read several files at once	Comparing files, batch processing
move_file	Move or rename files and directories	File organization, renaming
get_file_info	Get detailed metadata about files	File analysis, debugging

Directory Management

Create and explore directory structures:

Tool	Purpose	Best For
list_directory	Show all files and folders in a directory	Exploring project structure
create_directory	Create new directories with nested paths	Setting up project folders

Search & Discovery

Find files and content across your system:

Tool	Purpose	Best For
search_files	Find files by name using pattern matching	Locating specific files
search_code	Search for text content within files	Code search, content discovery

Process Management

Execute commands and manage terminal sessions:

Tool	Purpose	Best For
start_process	Start new terminal sessions or commands	Running scripts, starting REPL
interact_with_process	Send input to running processes	REPL interaction, command input
read_process_output	Read output from running processes	Getting command results
force_terminate	Stop running terminal sessions	Cleaning up processes
list_sessions	Show all active terminal sessions	Process monitoring

System Tools

Configure and monitor Desktop Commander:

Tool	Purpose	Best For
get_config	View current configuration settings	Understanding setup
set_config_value	Modify configuration settings	Customizing security
list_processes	Show all running system processes	System monitoring
kill_process	Terminate specific processes by ID	Process cleanup
get_usage_stats	View usage statistics and metrics	Usage analysis

Security Features

Desktop Commander includes several security mechanisms:

Command Blocking

Dangerous system commands are blocked by default (like rm -rf, format, shutdown)

Directory Restrictions

You can limit file access to specific directories for enhanced security

Process Isolation

Each terminal session runs in isolation to prevent interference

Configurable Permissions

Customize security settings to match your comfort level and requirements

Tool Usage Patterns

For Beginners

Start with these safe, simple tools:

1. list_directory - Explore your file system
2. read_file - View file contents
3. search_files - Find files by name
4. get_config - Understand your settings

For Data Analysis

Essential tools for working with data:

1. read_file - Load CSV/JSON files
2. start_process - Launch Python/R sessions
3. interact_with_process - Run analysis code
4. write_file - Save results and reports

For Development

Key tools for coding workflows:

1. search_code - Find code patterns
2. edit_block - Make precise code changes
3. read_multiple_files - Compare implementations
4. start_process - Run tests and builds

For File Management

Organize your files efficiently:

1. list_directory - Survey folder contents
2. move_file - Reorganize and rename
3. create_directory - Set up folder structures
4. search_files - Find misplaced files

Performance Tips

Desktop Commander works best with operations broken into smaller chunks. For large files or complex tasks, Claude will automatically handle this for you.

Always use absolute paths (like /Users/username/Documents/file.txt) rather than relative paths for reliability across different working directories.

Keep terminal sessions active for interactive work. You can maintain multiple sessions for different tasks simultaneously.

Next Steps

Detailed Tool Docs

Explore detailed documentation for each tool category

Use Case Examples

See practical examples of combining multiple tools

Security Configuration

Learn how to customize your security settings

Troubleshooting

Get help with common issues and questions