Tools Reference
WindOp's agent picks tools for you — you describe the goal, it chooses the right call. This page documents all 85 tools in 18 groups, so you know what it can (and cannot) do.
You never call these yourself
Just ask in plain language. Every tool call appears in the chat with its arguments and result. Tools that change your system ask for approval based on SettingsSecurity, and you can switch individual tools on or off in SettingsTools.Terminal & Shell
Execute commands across PowerShell, CMD, and WSL with auto-detection. Run foreground or background processes with full lifecycle management.
execRun shell commands with auto-detected shell. Shell detection: CMD syntax → CMD, PowerShell syntax → PS, neutral commands (npm/git/python) → PS, shell: "wsl" → Linux. Supports background mode for servers and long-running tasks.
Parameters
command (string), background (bool), timeout (number), workdir (string), shell (string)
Example
processManage background processes started with exec. List running processes, poll for new output, wait for completion, kill, or write to stdin.
Parameters
action (list|poll|wait|kill|log|write|submit|close), session_id (string), data (string), timeout (number)
Example
write_wsl_fileWrite files directly into the WSL filesystem with proper Windows-to-Linux path translation. Avoids shell-escaping issues with heredocs and echo.
Parameters
path (string), content (string), distro (string), executable (bool)
Example
File Operations
Full read/write/edit access to your Windows filesystem with smart fuzzy editing, ripgrep-grade search, checkpoints, and native file dialogs.
read_fileRead file contents with line numbers and pagination. Supports partial reads with offset/limit for large files.
Parameters
path (string), offset (number, 1-indexed), limit (number, default 500)
Example
write_fileCreate or overwrite files with full content. Auto-creates parent directories. Auto-runs syntax checks on .py, .json, .yaml, .toml files.
Parameters
path (string), content (string)
Example
edit_fileTargeted edits using fuzzy matching (9 strategies). Supports find+replace, multi-edit batches, line-range mode, and replace-all. Auto-runs syntax checks after editing.
Parameters
path (string), old_string (string), new_string (string), replace_all (bool)
Example
search_in_fileSearch for text within a single file. Returns matching lines with surrounding context. Use before read_file on large files to find exact line numbers.
Parameters
path (string), query (string), context (number)
Example
list_directoryList files and directories sorted by modification time. Supports recursive listing, glob filtering, and depth control.
Parameters
path (string), recursive (bool), pattern (string), depth (number)
Example
search_filesRipgrep-grade search across files in a directory tree. Supports regex patterns, glob filtering, context lines, and multiple output modes.
Parameters
pattern (regex string), path (string), file_glob (string), context (number), output_mode (content|files_only|count), max_results (number)
Example
create_directoryCreate an empty directory. Idempotent — does not error if the directory already exists.
Parameters
path (string)
Example
create_fileCreate a new file with content. Fails if the file already exists — use write_file to overwrite.
Parameters
path (string), content (string)
Example
append_fileAppend text to the end of an existing file. Creates the file if it does not exist.
Parameters
path (string), content (string)
Example
delete_fileDelete a file with automatic backup before removal. Accidental deletions can be recovered via restore_file.
Parameters
path (string)
Example
move_fileMove or rename files and directories. Auto-creates destination directories.
Parameters
source (string), destination (string)
Example
copy_fileCopy files to a new location. Auto-creates destination directories.
Parameters
source (string), destination (string)
Example
restore_fileRestore a file from its most recent backup created by delete_file or edit_file.
Parameters
path (string)
Example
list_file_backupsList available backups for a file. Shows timestamps and sizes of each backup.
Parameters
path (string)
Example
open_file_dialogOpen a native Windows file picker dialog for user file selection. Supports file type filters and multi-select.
Parameters
filters (array of {name, extensions}), multiple (bool)
Example
save_file_dialogOpen a native Windows save dialog for choosing save locations and file names.
Parameters
default_name (string), filters (array, optional)
Example
checkpoint_managerCreate, list, diff, or restore filesystem checkpoints for safe rollback. Snapshots file state before risky operations.
Parameters
action (create|list|diff|restore), paths (array), id (string)
Example
Web & Research
Search the web, fetch and extract page content, and maintain a local documentation library for offline reference.
web_searchSearch the web and return structured results with titles, URLs, and snippets. Use for up-to-date external information.
Parameters
query (string), maxResults (number)
Example
read_webpageFetch and extract webpage content as LLM-optimized structured text. Automatically strips ads, navigation, and clutter.
Parameters
url (string)
Example
fetch_webpageFetch raw webpage content without extraction. Returns the full HTML response.
Parameters
url (string)
Example
open_urlOpen a URL in the system default browser or a local file in its default application.
Parameters
url (string)
Example
download_fileDownload a file from a URL to a local path. Supports progress tracking for large files.
Parameters
url (string), destination (string)
Example
search_librarySearch the local documentation library using semantic/vector search. Returns relevant pages from previously crawled sources.
Parameters
query (string), limit (number)
Example
pull_library_docFetch the full content of a specific documentation page by URL from the local library.
Parameters
url (string)
Example
list_library_sourcesList all documentation sources in the library with metadata (page count, last sync, status).
Parameters
none
Example
sync_library_sourceRe-crawl and re-index a documentation source to update the local library.
Parameters
source_id (string)
Example
create_library_sourceCreate a new documentation source in the library by providing a base URL and crawl configuration.
Parameters
name (string), base_url (string), max_pages (number)
Example
crawl_and_storeEnd-to-end documentation crawler — crawls a site, scrapes pages, and stores them in the local library.
Parameters
url (string), max_pages (number), follow_links (bool)
Example
Browser Automation
Controlled browser with DOM access — navigate pages, click elements, type text, and take screenshots for vision analysis.
browser_navigateOpen or navigate the controlled browser to a URL. Returns a compact page snapshot with interactive elements and ref IDs.
Parameters
url (string)
Example
browser_snapshotGet a text-based snapshot of the current page's accessibility tree. Returns interactive elements with ref IDs for click/type actions.
Parameters
full (bool, default false)
Example
browser_clickClick an interactive element from the latest browser snapshot by its ref ID (e.g., @e5).
Parameters
ref (string, e.g. "@e5")
Example
browser_typeType text into an input element from the browser snapshot by ref ID. Clears the field first, then types the new text.
Parameters
ref (string), text (string)
Example
browser_pressPress a keyboard key in the controlled browser. Useful for submitting forms (Enter), navigating (Tab), or shortcuts.
Parameters
key (string, e.g. "Enter", "Tab", "Escape")
Example
browser_screenshotTake a screenshot of the current browser page for vision analysis. Returns the image for visual inspection.
Parameters
none
Example
Desktop Automation
Full Windows desktop control — screenshot capture with AI vision, mouse/keyboard automation, and application management.
computer_controlUnified desktop session tool for full-PC screen viewing and mouse/keyboard automation. Uses AI vision to understand your screen like a human would. Actions: screenshot, find_element, click, move, drag, scroll, type, key, wait, cursor_position.
Parameters
action (screenshot|find_element|click|move|drag|scroll|type|key|wait|cursor_position), x/y (number), query (string), text (string), direction (up|down)
Example
launch_applicationLaunch Windows applications by path or name. Auto-detects installed apps from the Start Menu and PATH.
Parameters
name_or_path (string)
Example
Image & Video
AI-powered image generation, analysis, and video creation through OpenRouter's multimodal models.
generate_imageGenerate images from text prompts or edit existing images via OpenRouter. Supports multiple providers, style presets, and aspect ratios. Returns the image inline in the chat.
Parameters
prompt (string), style (string), resolution (string), aspect_ratio (1:1|16:9|4:3|3:4)
Example
analyze_imageAnalyze images using vision AI. Supports single images, batches, or entire directories. Returns detailed descriptions and answers questions about the image content.
Parameters
path (string), question (string)
Example
describe_image_for_generationCreate a detailed, optimized image generation prompt from a basic idea. Expands vague descriptions into production-ready prompts.
Parameters
description (string)
Example
list_image_modelsList available image generation models with their capabilities, supported styles, and pricing.
Parameters
none
Example
generate_videoGenerate a short AI video through OpenRouter. Supports text-to-video and image-to-video modes.
Parameters
prompt (string), source_image (string, optional), duration (number)
Example
Text-to-Speech
Convert text to natural-sounding speech audio using configurable TTS providers.
text_to_speechConvert text to speech using the configured TTS provider (Edge TTS, OpenAI, or custom). Returns an audio file that plays inline in the chat.
Parameters
text (string), output_path (string, optional)
Example
Git Version Control
Native Git operations with full staging, commit, push, and branch management. Always prefer this over exec for git commands.
gitUnified Git operations: status, log, diff, branch, add, commit, push, pull. Handles authentication, upstream tracking, and merge conflict detection.
Parameters
action (status|log|diff|add|commit|push|pull|branch), files (string/array), message (string), cwd (string)
Example
Code Execution
Execute code in a sandboxed environment with support for multiple languages.
execute_codeExecute code in a sandboxed environment. Supports Python, JavaScript, TypeScript, and Bash. Returns stdout, stderr, and exit code.
Parameters
language (python|javascript|typescript|bash), code (string), timeout (number)
Example
Windows System Tools
Deep Windows OS integration — registry, services, scheduled tasks, event logs, networking, updates, disk management, and Defender.
windows_registryRead, write, delete, list, and search Windows Registry keys. Full access to HKLM, HKCU, and other hives.
Parameters
action (read|write|delete|list|search), key (string), value_name (string), value (string), data_type (string)
Example
windows_servicesList and manage Windows services. Start, stop, restart, and inspect service status and configuration.
Parameters
action (list|start|stop|restart|status), name (string), filter (string)
Example
windows_task_schedulerList, create, delete, run, enable, and disable Windows Scheduled Tasks.
Parameters
action (list|create|delete|run|enable|disable), task_name (string), config (object)
Example
windows_event_logQuery, list, and clear Windows Event Logs. Filter by log name, level, source, and time range.
Parameters
action (query|list|clear), log_name (string), level (string), source (string), max_entries (number)
Example
windows_networkRun Windows network diagnostics and Wi-Fi operations. View connections, ping hosts, manage Wi-Fi profiles, and check DNS.
Parameters
action (diagnostics|wifi|connections|ping|dns), target (string), profile (string)
Example
windows_updatesInspect and manage Windows Updates. List available updates, check update history, and trigger installations.
Parameters
action (list_available|history|install), update_id (string)
Example
windows_diskInspect Windows volumes, disk usage, cleanup candidates, and defragmentation status.
Parameters
action (usage|cleanup|defrag_status|volumes), drive (string)
Example
windows_defenderInspect Windows Defender status, start scans, view threat history, and manage real-time protection settings.
Parameters
action (status|scan|threats|settings), scan_type (quick|full|custom), path (string)
Example
Development Tools
Windows developer environment setup — detect runtimes, manage packages across 7 package managers, configure terminals, and bridge to WSL.
windows_dev_environmentDetect and provision Windows development runtimes using winget. Check for Node.js, Python, Rust, Go, Java, .NET, and more.
Parameters
action (detect|install|check), runtime (string), version (string)
Example
windows_terminal_setupInspect and customize Windows Terminal, Oh My Posh, Starship, and Nerd Fonts. Configure profiles, themes, and prompt styling.
Parameters
action (status|install|configure), component (string), config (object)
Example
install_packagesSmart unified package manager supporting winget, choco, scoop, npm, pip, cargo, and go. Auto-detects the right manager for the package.
Parameters
manager (winget|choco|scoop|npm|pip|cargo|go), action (install|uninstall|update|search|list), package (string)
Example
wsl_bridgeBridge between Windows and WSL Linux environments. List distros, run commands, copy files between filesystems, and manage WSL instances.
Parameters
action (list_distros|run_command|copy_to_wsl|copy_from_wsl|status), command (string), source (string), destination (string), distro (string)
Example
Multi-Agent Teams
Create specialist agent teams that collaborate on complex tasks — parallel research, code review pipelines, and multi-perspective analysis.
create_teamCreate a specialist agent team with custom roles and execution mode. Supports parallel, sequential, and discussion-based execution.
Parameters
id (string), members (array of role strings) or memberSpecs (array of {role, goal}), mode (parallel|sequential|discussion)
Example
run_teamExecute a previously created team on a task. The supervisor coordinates members, collects results, and synthesizes a final answer.
Parameters
id (string), task (string)
Example
create_group_chatCreate a group chat with specialist agents for multi-turn discussion. Agents can respond to each other, building on previous messages.
Parameters
agents (array of role strings) or agentSpecs (array), id (string), maxTurns (number), speakerSelectionMethod (round_robin|random|auto)
Example
add_agent_to_chatAdd another specialist agent to an existing group chat for expanded perspectives.
Parameters
id (string), agent (string) or agentSpec (object)
Example
run_group_chatRun a previously created group chat on a specific topic or task.
Parameters
id (string), task (string)
Example
get_autogen_statusInspect current group chats, teams, and temporary specialist agents for this session.
Parameters
none
Example
Memory & Context
Persistent memory system that survives across sessions — categorized entries, daily logs, and full-text search across conversation history.
write_to_memoryManage bounded long-term memory. Actions: add (new entry), replace (update existing), remove (delete). Categories: preference, knowledge, pattern, insight.
Parameters
category (preference|knowledge|pattern|insight), content (string)
Example
create_daily_logAdd timestamped entries to the daily log file. Entry types: event, decision, learning, task, note.
Parameters
type (event|decision|learning|task|note), content (string)
Example
session_searchSearch across all past conversations using full-text search. Returns matching messages with context from historical sessions.
Parameters
query (string), limit (number)
Example
search_past_conversationsSearch across all past conversations with advanced filtering. Finds historical context, decisions, and code snippets.
Parameters
query (string), limit (number)
Example
Skills System
Reusable skill library — create, discover, install, and manage procedural knowledge that WindOp can load on demand.
load_skillLoad a skill's full instructions and supporting files. Skills provide specialized knowledge for specific task types.
Parameters
name (string), scope (global|project|area), projectPath (string)
Example
list_skillsList all available skills (global + project-scoped). Shows name, scope, description, and trigger patterns.
Parameters
projectPath (string, optional)
Example
create_skillCreate a new reusable skill with markdown instructions, trigger patterns, and optional supporting files.
Parameters
name (string), description (string), content (string), scope (global|project), triggers (array), tags (array)
Example
search_skill_hubSearch configured skill hub sources for community-shared installable skills.
Parameters
query (string)
Example
install_skillInstall a skill from the hub or a URL. Skills are stored locally and can be loaded on demand.
Parameters
url (string) or query (string), scope (global|project), overwrite (bool)
Example
update_skillsCheck for and apply updates to hub-managed skills. Can target a specific skill or check all.
Parameters
apply (bool), skillName (string)
Example
delete_skillArchive a skill without permanently deleting it. The skill can be restored if needed.
Parameters
name (string), scope (global|project), projectPath (string)
Example
Kanban Boards
Local kanban project management — create boards, manage tasks, and dispatch work to sub-agents.
kanban_boardCreate, fetch, and list local kanban boards. Boards track project tasks across customizable columns.
Parameters
action (create|fetch|list), name (string), columns (array), id (string)
Example
kanban_taskCreate, update, move, assign, decompose, block, unblock, complete, and delete tasks on kanban boards.
Parameters
action (create|update|move|assign|decompose|block|unblock|complete|delete), board_id (string), task_id (string), title (string), column (string), assignee (string)
Example
kanban_dispatchDispatch kanban tasks to configured sub-agents for automated execution. Agents pick up tasks and report progress.
Parameters
board_id (string), task_id (string), agent (string), config (object)
Example
Integrations
Connect WindOp to external tools via MCP servers, webhooks, and its own MCP server mode for external clients.
manage_mcp_serversMCP integration manager — setup, list, import, remove, connect, disconnect, and refresh MCP server connections. Supports Claude Code, Codex CLI, and local tools.
Parameters
action (setup|list|import|remove|connect|disconnect|refresh|export|import_common_configs), server_id (string), config (object)
Example
manage_windop_mcp_serverManage WindOp's own MCP server mode, allowing external MCP clients (Claude Code, Codex, etc.) to connect and use WindOp's tools.
Parameters
action (start|stop|status|config), port (number), config (object)
Example
manage_webhooksManage local webhook endpoints — create, list, delete, and test webhook listeners for event-driven automation.
Parameters
action (create|list|delete|test), url (string), event (string), config (object)
Example
Observability
Local usage analytics — track token consumption, costs, tool usage, and detailed conversation traces.
get_metricsGet local usage metrics including token consumption, estimated costs, tool usage frequency, and latency statistics.
Parameters
range (today|week|month|all)
Example
get_traceGet a detailed local trace for a conversation turn — shows tool calls, latencies, token usage, and decision flow.
Parameters
conversation_id (string), turn_id (string)
Example
User Interaction
Interactive dialogs and prompts for human-in-the-loop workflows.
ask_humanPause execution and ask the user a question. Returns their free-form response. Use when you need clarification, a decision, or credentials.
Parameters
question (string)
Example
Something missing or out of date? Tell us on the community page.