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.