Tools are capabilities Maestro invokes autonomously. Unlike commands (user-initiated), tools are selected by Maestro based on the task.

​
File Tools

ToolDescription
View FilesDisplays content of files in the workspace. Supports specific iterations.
List FilesLists files matching glob patterns with goal-directed filtering. Recursive matching, exclusion patterns, directory scoping.
Search FilesText search across files. Case-sensitive/insensitive, word boundary detection, regex, multi-file bulk operations.
Analyze FilesAnalyzes file content against specific queries for structure, patterns, or issues.
Copy FilesCreates copies at new locations. Single copies, bulk copies with pattern transformations, directory copies.
Move FilesMoves files to new locations. Single moves, bulk moves with pattern transformations, directory moves.
Delete FilesRemoves files. Reversible via Restore Files.
Restore FilesRecovers deleted files or restores to previous iterations. Creates a new iteration with previous content.
Hide FilesRemoves from view without deleting. Hidden files do not consume capacity.
Display to UserShows specific files in the UI.
View RenderedRenders SVG files as PNG images.
Compute DiffsCompares file iterations. Specific ranges or cumulative session review (iteration 0 to latest).

​
Coding Tools

ToolDescription
PROPOSE_NEWCreates new files.
PROPOSE_EDITModifies existing files.
PROPOSE_OVERWRITEReplaces entire file content.
Apply ChangesCommits all pending proposals to the codebase. Syncs to sandbox and creates new file iterations. Proposals remain pending until this tool runs.

​
Browser Tools

ToolDescription
Browser OperatorInteractive browser automation. Mouse interactions (clicks, scrolls, drag-drop), keyboard input, form filling, navigation, screenshot capture. Supports device simulation for mobile, tablet, and desktop viewports. Public URLs only. Supported devices include Desktop Chrome/Safari/Firefox, iPhone 6-15 series, iPad Pro/Mini, Galaxy S9+/Tab S9, Pixel 7.

​
Complex Thinking Tools

ToolDescription
Complex CodingExtended reasoning for complex multi-file software engineering tasks. High reasoning budget. References specifications and patterns. Invokes Apply Changes after generation.
Complex ReasoningAdvanced analytical reasoning. Produces comprehensive markdown reports saved to desktop/complex_reasoning/\{label\}.md.

​
Creative Tools

ToolDescription
Generate ImageImage generation using Gemini 3 Pro. Aspect ratios: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3.
Generate SVGVector graphics using Recraft v3 SVG. Styles: any, engraving, line_art, line_circuit, linocut.

​
Diagram Tools

ToolDescription
PlotlyInteractive data visualizations using Plotly JSON structure. Chart types: scatter, bar, line, area, pie, box, violin, histogram, heatmap, contour, surface, scatter3d, candlestick, waterfall, choropleth, sunburst, treemap, sankey, funnel, indicator.
MermaidDiagrams from Mermaid syntax (v10.6.1). Diagram types: flowcharts, sequence, class, state, Gantt, ER, user journey. Themes: default, dark, forest, neutral.
Diagram (DOT)Diagrams from DOT/Graphviz content.

​
Download Tools

ToolDescription
Download to UserFile downloads. Modes: changed files, specific files, specific directory, everything.

​
Secret Tools

ToolDescription
Manage SecretsActivates or deactivates secrets as sandbox environment variables.

​
Programming Tools

ToolDescription
Execute CommandRuns commands in sandbox terminal. Named windows, parallel execution, terminal streaming, background execution, soft timeout. Running a new command in an active window cancels the previous command.
Terminal OperatorInteractive terminal operations. TUIs, prompts, adaptive input, keystroke-level control. Perceives terminal output and decides actions adaptively.
Check Terminal WindowChecks status and content of a terminal window. No side effects on running commands. Returns status, last command, scrollback, running processes.
Close Terminal WindowsCloses terminal windows, cancelling foreground tasks.

​
Sandbox Tools

ToolDescription
Create SandboxCreates named sandbox instances. Parameters: cpu_count (1-16), memory_gb (1-64), gpu_type (A10G/A100/T4/L4/H100), gpu_count (1-8), privileged (enables Docker), ssh_connection (username@host:port), docker_image (e.g., python:3.11). Resource parameters and SSH parameters cannot be combined.
Terminate SandboxTerminates a named sandbox instance. The “default” sandbox cannot be terminated.

​
Search Tools

ToolDescription
Google SearchWeb search via Google. Optimized for speed and freshness.
Perplexity SearchMulti-source web research with citations. Depth levels: search (15s avg, 3000 chars), research (33s avg, 4600 chars), deep-research (93s avg, 7600 chars). Supports domain filtering, recency filtering, citation validation.

​
Source Control Tools

ToolDescription
Github Clone RepositoryClones repositories from GitHub, GitLab, Bitbucket, or other Git providers. Supports private repos, specific branches/commits, PR URLs, multiple clones.
Github Create RepositoryCreates GitHub repositories with optional templates and auto-clone.
Github Pull RequestCreates or updates pull requests. Handles file selection, branch management, diff computation.
Github Add CommentsAdds comments to GitHub Issues or Pull Requests.
Github Manage Review CommentsManages code review comments on GitHub PRs.

​
Web Tools

ToolDescription
Visit URLRetrieves content from public URLs. Handles web pages (text extraction), PDFs (text conversion), text files. Optional console log capture.
Screenshot WebpageScreenshots public web pages with browser console logs. Public URLs only.

​
Turn Lifecycle Tools

ToolDescription
End TurnEnds the current processing turn.

​
Availability Notes

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.