Skip to content

Installation

Install from npm

npm install -g tauri-agent-tools

Verify the installation:

tauri-agent-tools --version

System Requirements

Node.js >= 20 is required (uses native fetch()).

Platform-specific tools are also needed for screenshot and window operations:

sudo apt install xdotool imagemagick

Tools used: xdotool (window search/geometry), ImageMagick (screenshot capture via import, crop/resize via convert/magick).

Both ImageMagick v6 (convert) and v7 (magick) are supported automatically.

sudo apt install sway grim imagemagick

Tools used: swaymsg (window listing/geometry), grim (screenshot capture), ImageMagick (crop/resize).

sudo apt install grim imagemagick
# hyprctl is included with Hyprland

Tools used: hyprctl (window listing/geometry), grim (screenshot capture), ImageMagick (crop/resize).

brew install imagemagick

Built-in tools used: screencapture, osascript, sips. ImageMagick provides crop/resize.

Screen Recording Permission

Grant Screen Recording permission in System Settings > Privacy & Security > Screen Recording for your terminal app.

Build from Source

git clone https://github.com/cesarandreslopez/tauri-agent-tools.git
cd tauri-agent-tools
npm install
npm run build
npm link

Verify Setup

Run a quick check to ensure platform tools are available:

# This will report any missing tools
tauri-agent-tools list-windows

If any required tools are missing, the CLI will report which ones to install.

Dependencies by operation

list-windows, info, and wait --title check only the window tool (xdotool, swaymsg, hyprctl, or osascript). They do not check ImageMagick. Full-window PNG capture on macOS/Wayland uses native capture tools; crops, resizing, JPEG output, image comparison, and X11 capture require ImageMagick. Bridge-only and bridge-free diagnostic commands do not require a display server or screenshot tools.

Use probe --json to inspect bridge discovery and the selected PID, port, and window label. A successful window listing verifies only window-inspection prerequisites.