Execute a shell command on this Windows PC and return its output. Use this tool to run any CLI command: package installation (npm, pip, cargo), code compilation, file management via CLI, registry queries, network diagnostics (ping, tracert, ipconfig), git operations, build scripts, or anything that can run in a terminal. Default shell is PowerShell with a timeout of 30 seconds. Returns both STDOUT and STDERR. The 'shell' parameter switches to Git Bash or WSL for Unix-style commands (ls, grep, bash scripts). WARNING: Dangerous commands will still execute — make sure the command is correct before running.

Read and return the full text contents of a file on this Windows PC. Supports all text-based files: .txt, .json, .js, .ts, .py, .md, .csv, .xml, .yaml, .html, .css, .log, .env, .ini, .bat, .ps1, .toml, and other text files. Use this to view configuration files, read source code, inspect log files, or extract data from files. Files are read in text mode with UTF-8 encoding by default. For binary files (images, videos, etc.), use a different approach. Path must be absolute (e.g., C:\Users\rayss\Documents\config.json).

Write text content to a file on this Windows PC. If the file does not exist, it will be created automatically along with any missing parent directories (auto-create directory). If the file already exists, its entire content will be overwritten (full replacement). Use this to create new configuration files, save processed data output, write source code, generate scripts, or update files by rewriting their full content. Path must be absolute. Content is written in UTF-8 encoding.

List the contents of a folder/directory on this Windows PC. Shows file/folder names, type (📁 folder or 📄 file), file size (in KB/MB/GB), and last modified date. Supports recursive mode to display contents of sub-folders up to 3 levels deep. Use this to explore folder structures, locate files, check file sizes, or inspect directory contents. If no path is provided, lists the user's home directory (C:\Users<username>).

Capture a screenshot (screen grab) of the primary monitor on this Windows PC. Returns the screenshot image in PNG format as base64 data that the AI can directly view and analyze. Use cases: see what's currently displayed on screen, debug UI issues in applications, verify visual changes, create visual documentation, or monitor what's showing on the display. Screenshot is captured using .NET System.Drawing from the primary monitor at full resolution. Optionally save the screenshot to a specific file path on disk.

Retrieve detailed and comprehensive system information about this Windows PC. Includes: hostname/computer name, OS version and architecture, uptime (how long the PC has been running), CPU model and core count, CPU clock speed, total RAM and free/used RAM (in human-readable format), disk/storage information (drive letters, used space, free space per partition), and network information (IP address per interface). Useful for diagnostics, resource monitoring, checking PC specifications, or troubleshooting system issues.

Search for files on this Windows PC by name pattern (glob/wildcard). Search is performed recursively through all sub-folders. Supports wildcards like *.txt, .jpg, .json, config, report_.xlsx, and other patterns. Use this to find misplaced files, locate all files with a specific extension, discover configuration files, or audit files in a directory. Uses PowerShell Get-ChildItem for fast search performance. Results show the absolute path of each matching file found.

Display a list of processes/applications currently running on this Windows PC. Shows process name, Process ID (PID), memory usage (in MB), and CPU time (in seconds). Can be filtered by process name (partial match) to find specific processes. Can be sorted by name, memory usage (find RAM hogs), or CPU usage (find CPU hogs). Shows the top 30 processes. Useful for monitoring, debugging, finding resource-consuming processes, or identifying processes before killing them.

Force-terminate a running process on this Windows PC. Can target by process name (kills ALL instances with that name) or by Process ID/PID (kills a specific process). The process is force-killed without confirmation. Use this to stop hung/frozen applications, close unwanted programs, or free up blocked resources. WARNING: Use with caution — killed processes cannot be recovered and any unsaved data will be lost.

Open a file, folder, or URL using the default application on this Windows PC. For files: opens with the registered application (e.g., .pdf in PDF reader, .jpg in image viewer, .docx in Word). For folders: opens in Windows Explorer. For URLs: opens in the default web browser. Use this to open documents, launch applications via file shortcuts, browse folders in Explorer, or open websites in the browser. Uses Windows Start-Process under the hood.

Read the current text content of the Windows system clipboard (the last copied item). The clipboard is the temporary storage area for copy/paste operations. With this tool, the AI can read what's currently in the clipboard — useful to grab data copied from other applications or verify what was last copied. Returns "(clipboard is empty)" when nothing is copied.

Copy text to the Windows system clipboard so the user can immediately paste it (Ctrl+V) in any application. The clipboard is the temporary storage area for copy/paste operations. Use cases: copy command output to the clipboard, transfer text between applications, or automate copy-paste workflows. Requires the 'text' parameter with the content to copy.

Execute a long-running shell command on this Windows PC and return all output after completion. Unlike run_command, this tool has a default timeout of 2 minutes (120 seconds) and is designed for commands that take a long time: npm install, pip install, compiling large projects, downloading big files, building projects, git clone large repositories, running test suites, or backup processes. Command runs through PowerShell.exe with a larger output buffer. Returns STDOUT, STDERR, and exit code.

Create a ZIP archive from files or folders using PowerShell Compress-Archive. Use this tool to compress files/folders into a .zip file for backup, sharing, or archiving. Supports wildcards in source (e.g. "D:\logs*.log"). The destination path should end in .zip.

Extract a ZIP archive to a destination folder using PowerShell Expand-Archive. Use this tool to unzip archives. The destination folder is created automatically if it doesn't exist.

Bring a window to the foreground by matching its title or process name (case-insensitive). Use this tool to switch focus to a specific application window before sending keys or interacting with it. Example: "Notepad", "Visual Studio Code", "chrome" — matches any open window whose title contains the text. Returns an error if no matching window is found.

Type text or send keystrokes to the currently focused window using PowerShell SendKeys. Call window_focus first to make sure the target window is active. For literal text, pass 'text' (special characters are escaped automatically). For shortcuts and special keys, pass 'keys' as a raw SendKeys string: ^c (Ctrl+C), ^v (Ctrl+V), {ENTER}, {TAB}, {ESC}, {BACKSPACE}, {DEL}, {UP}, {DOWN}, {LEFT}, {RIGHT}, {F1}..{F12}, %{F4} (Alt+F4). Example: keys="^s" saves the focused file.

Show a Windows notification balloon with the given title and message. Use this tool to notify the user when a long task finishes, when something needs their attention, or to display information without opening a window. The notification stays visible for ~6 seconds.