> ## Documentation Index > Fetch the complete documentation index at: https://docs.igent.ai/llms.txt > Use this file to discover all available pages before exploring further. # Tools Understanding Maestro's autonomous capabilities. ## What Are Tools? Tools are capabilities Maestro invokes autonomously to accomplish your goals. Unlike commands (which you trigger), tools are Maestro's "hands"--the mechanisms through which it interacts with code, sandboxes, the web, and external services. **You don't invoke tools directly**--you set goals, and Maestro selects appropriate tools to achieve them. However, you can: * Steer Maestro toward specific tools through natural language * Manage which tools are available via `/tools` command * Understand what tools do to better collaborate with Maestro ## Tool Categories ### File Tools Maestro uses these to understand and manipulate your project's files. #### View Files View the content of files in your workspace. **Replaces**: Using `cat` or editors in sandbox\ **Why separate**: Efficient file access, iteration support, token optimization **Example invocation**: ``` "Show me the authentication implementation" → Maestro uses View Files to examine auth.py ``` #### List Files List files matching specific patterns with goal-based filtering. **Capabilities**: * Glob pattern matching (`**/*.py`, `src/**/*test*.js`) * Goal-directed filtering (shows relevant files for stated goal) * Fast codebase navigation **Example**: ``` "Find all configuration files" → Maestro uses List Files with pattern "**/*config*" ``` #### Search Files Perform text searches across files using patterns or regex. **Features**: * Case-sensitive/insensitive matching * Word boundary detection * Regular expression support * Multi-file searches **Example**: ``` "Find where the UserService class is defined" → Maestro searches for "class UserService" ``` #### Analyze Files Analyze file content with specific queries. **Use cases**: * Understanding code structure * Extracting insights * Identifying patterns * Security analysis **Example**: ``` "Analyze all API endpoints and list their rate limits" → Maestro analyzes route files, extracts rate limit info ``` #### File Operations * **Copy Files**: Create copies with pattern transformations * **Move Files**: Reorganize with bulk operations * **Delete Files**: Remove files (reversible via Restore) * **Restore Files**: Recover deleted files or previous iterations * **Hide Files**: Remove from view without deleting #### Display and Rendering * **Display to User**: Show specific files in UI * **View Rendered**: Render SVG files as PNG images #### Compute Diffs Compare file iterations to understand changes. **Modes**: * Specific iteration ranges * Cumulative session review (iteration 0 → latest) **Example**: ``` "Show me what changed in auth.py" → Maestro computes diff between iterations ``` ### Coding Tools Tools for creating and modifying code. #### Code Proposals Maestro doesn't directly edit files--it proposes changes: **PROPOSE\_NEW**: Create new files **PROPOSE\_EDIT**: Modify existing files **PROPOSE\_OVERWRITE**: Replace entire file **Note**: Proposals are not applied automatically. Maestro must explicitly use Apply Changes (see Merge Tools section). ### Browser Tools Interact with web pages through automated browser control. #### Browser Operator Interactive browser automation for clicking, typing, scrolling on public URLs. **Capabilities**: * Mouse interactions (clicks, scrolls, drag-drop) * Keyboard input * Form filling * Navigation * Screenshot capture **Use cases**: * Testing web applications * Automated workflows * Data extraction * UI validation **Supports**: Mobile device simulation (iPhone, Android, tablets) ### Complex Thinking Tools Advanced reasoning capabilities for complex problems. #### Complex Coding Deep reasoning for complex software engineering tasks with automatic code application. **When Maestro uses it**: * Implementation requires deep reasoning * Multiple architectural concerns to balance * Coordinating changes across 3+ files * Complex algorithms requiring optimization **Capabilities**: * High-reasoning budget for complex problems * References specifications and pattern files * Automatically applies changes after generation * Iterative refinement with prior attempt feedback #### Complex Reasoning Advanced analytical reasoning for complex problems, generates markdown reports. **When Maestro uses it**: * Multiple interdependencies to analyze * Trade-off evaluation needed * Architectural design decisions * Research synthesis **Output**: Comprehensive markdown report at `desktop/complex_reasoning/\{label\}.md` ### Creative Tools Generate images and creative content. #### Generate Image Generate images using advanced image generation models. **Use cases**: * Creating visual assets * Mockups and prototypes * Illustrations and graphics * Visual documentation ### Diagram Tools Create diagrams and visualizations. #### Plotly Create interactive data visualizations and charts using Plotly's JSON structure. **Chart types**: Line, bar, scatter, pie, heatmaps, statistical, financial, maps, specialized diagrams #### Mermaid Generate diagrams from Mermaid syntax. **Diagram types**: Flowcharts, sequence diagrams, class diagrams, state diagrams, Gantt charts, ER diagrams, user journeys #### Diagram Generate diagrams from DOT/Graphviz content for complex graph visualizations. ### Download Tools #### Download to User Provide file downloads to the user (changed files, specific files, directories, or everything). **Modes**: * **Changed files**: Only modified/created files * **Specific files**: Files you enumerate * **Specific directory**: Entire directory * **Everything**: All session files * **Recent**: Last 5 modified files ### Secret Tools #### Manage Secrets Activate or deactivate secrets in the sandbox. **Operations**: * Activate: Make secrets available as environment variables * Deactivate: Remove secrets from environment ### Merge Tools #### Apply Changes Apply proposed file changes to the codebase. **Critical**: Proposals are not applied automatically. Maestro must explicitly use Apply Changes. **What it does**: * Reviews all pending proposals * Applies them to your file tree * Syncs to sandbox * Creates new file iterations * Preserves history ### Perplexity Tools #### Perplexity Search In-depth web research with multi-source synthesis and citations. **When Maestro uses it**: * Comprehensive technical research * Understanding complex topics * API usage and best practices * Troubleshooting and debugging * Comparative analysis **Modes**: * **Search**: Quick technical questions (15s avg) * **Research**: Complex topics with multi-step thinking (33s avg) * **Deep Research**: Extensive multi-source analysis (93s avg) **Features**: * Citations and sources * Domain filtering * Recency filtering * Citation validation ### Programming Tools Execute and manage commands in the sandbox. #### Execute Command Execute commands in the sandbox terminal. **Use cases**: * Running tests * Installing dependencies * Building projects * Starting servers **Features**: * Named windows (isolate different activities) * Terminal streaming (see output in real-time) * Background execution (servers keep running) * Non-interactive by default #### Terminal Operator Interactive terminal operations for TUIs, prompts, and adaptive input. **Use cases**: * Navigating TUI applications * Responding to prompts * Interactive debuggers (gdb, pdb) * Menu-driven CLIs **How it works**: * Perceives terminal output * Decides on next action adaptively * Sends appropriate keystrokes * Continues until goal achieved #### Check Terminal Window Check status and content of a terminal window. **Use cases**: * Supervising long-running builds * Checking server status * Monitoring test execution * Reviewing command history **No side effects**: Doesn't cancel or interrupt running commands #### Close Terminal Windows Close one or more terminal windows. **Use cases**: * Stopping development servers * Cleaning up after testing * Managing terminal resources * Cancelling hung processes #### Compute Diffs Compute and display diffs between file iterations. **Modes**: * Specific iteration ranges * Cumulative session review (iteration 0 → latest) ### Sandbox Tools Manage sandbox instances. #### Create Sandbox Create new named sandbox instances (with optional GPU, SSH, Docker support). **Capabilities**: * Standard sandboxes with custom resources * GPU sandboxes for machine learning * Privileged sandboxes with Docker support * SSH connection to remote systems #### Terminate Sandbox Terminate a named sandbox instance. ### Search Tools #### Google Search Perform web searches via Google. **When Maestro uses it**: * Finding documentation links * Locating library downloads * Quick fact checking * Recent news or updates **Optimized for**: Speed and freshness (last \~7 days) ### Source Control Management Tools GitHub integration capabilities. #### Github Clone Repository Clone Git repositories (GitHub, GitLab, Bitbucket, etc.). **Capabilities**: * Clone private repositories (with GitHub authentication) * Clone specific branches or commits * Clone pull request URLs directly * Multiple clones of same repo (for comparisons) #### Github Create Repository Create new GitHub repositories. **Configuration options**: * Repository name and description * Public or private visibility * GitIgnore and license templates * Organization ownership * Auto-clone (enabled by default) #### Github Pull Request Create pull requests from workspace to GitHub. **Workflow**: 1. Select files to include in PR 2. Choose target repository and base branch 3. Provide PR title and description 4. Review changes (diff view) 5. Confirm and create/update #### Github Add Comments Add comments to GitHub Issues or Pull Requests. #### Github Manage Review Comments Manage code review comments on GitHub PRs. ### Turn Lifecycle Tools #### End Turn Explicitly end the current turn. ### Web Tools Interact with web content. #### Visit Url Retrieve content from public URLs. **Handles**: * Web pages (extracts text) * PDFs (converts to text) * Text files * With optional browser console logs #### Screenshot Webpage Take screenshots of web pages with console logs. **Use cases**: * Inspecting page layouts * Debugging frontend issues * Gathering console errors * Documenting UI state **Note**: Requires public URL (no localhost) ## Tool Availability Notes **Not all tools are always available**: * Execution tools require `execution` enabled in configuration * Some tools are hidden by default (experimental/deprecated) * Complex tools may be disabled in budget modes * GitHub GraphQL tools are feature-flagged **Use `/tools` command to see what's currently available in your session.** ## Next Steps Understanding tools enables better collaboration: * **[Sandbox Guide](getting-started/sandbox)**: Deep dive into execution environment * **[Source Control](getting-started/source-control)**: GitHub integration workflows * **[Session Strategies](getting-started/session-strategies)**: Patterns for different projects * **[Advanced Features](getting-started/advanced-features)**: Power user capabilities