Skip to main content

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.

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

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

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: