AgiMate Desktop

A specialized AI agent on your computer: monitors files, events, and notifications, executes commands. Install once — and forget.

How the Desktop agent works

AgiMate Desktop lives in the system tray — monitors events on your computer and passes them to your AI agents.

PC Events
Files, buttons, timers
HTTP ↑ / WebSocket ↓
AgiMate Desktop
System tray · Background agent
AI Agent
Analysis and commands
1

An event occurs on the computer

A new file in a folder, a button press, or a timer trigger — a plugin intercepts the event.

2

The agent sends data to the server

AgiMate Desktop transmits the event to the backend via HTTP. Data includes type, time, and parameters.

3

AI makes a decision

Your AI agent (via n8n, MCP, or webhook) analyzes the event and chooses an action.

4

The command is executed on the computer

The response command arrives via WebSocket — notification, speech, or another plugin action.

Built-in capabilities

Built-in triggers and actions — work right after installation.

Triggers

File Watcher

Real-time folder monitoring. New file, change, deletion, move — the agent instantly notifies AI.

  • Recursive monitoring of nested folders
  • Filter by mask: *.pdf, *.doc*, *.xlsx
  • Data: path, filename, size, event type
  • Example: new invoice in Downloads → AI sends to 1C

Quick Buttons

Customizable button panel for manual triggers. Press — and AI runs a configured scenario.

  • Two types: instant and with text input
  • Configurable grid (column count)
  • Live configuration editor
  • Example: 'Quick Note' → input dialog → AI saves to Notion

Actions

Notifications

AI sends notifications right to your desktop. System ones — to tray. Important ones — as modal windows.

  • System notification (background) and modal window
  • Customizable title, text, and duration
  • Example: AI found suspicious order → modal notification

Text-to-Speech (TTS)

AI speaks text through your computer speakers. Don't miss important events, even when not looking at the screen.

  • macOS: built-in say command with voice selection
  • Windows: SAPI via PowerShell (built into system)
  • Linux: espeak or spd-say
  • Example: critical alert → 'Attention, warehouse stock is below minimum'

Extend as you wish

Each plugin is a folder with code and config. Write your own in 30 minutes or use community-made ones.

Trigger plugins

Monitor events on the computer and send data to the AI agent.

Device → AIFiles, buttons, timers

Action plugins

Receive commands from AI and execute actions on the computer.

AI → DeviceNotifications, TTS, automation
Direction
Trigger plugin
Device → AI
Action plugin
AI → Device
Purpose
Trigger plugin
Monitors events
Action plugin
Executes commands
Examples
Trigger plugin
Files, buttons, timers
Action plugin
Notifications, TTS
Base class
Trigger plugin
TriggerPlugin
Action plugin
ActionPlugin
Trigger plugin example (Python)
from core.plugin_base import TriggerPlugin

class MyTrigger(TriggerPlugin):
    @property
    def name(self) -> str:
        return "My Trigger"

    async def start(self) -> None:
        # Start monitoring
        pass

    async def stop(self) -> None:
        # Stop monitoring
        pass
Action plugin example (Python)
from core.plugin_base import ActionPlugin

class MyAction(ActionPlugin):
    @property
    def name(self) -> str:
        return "My Action"

    def get_supported_actions(self) -> list[str]:
        return ["MY_ACTION"]

    async def execute(self, action_type: str,
                      parameters: dict) -> bool:
        # Execute action
        return True

What you can automate

Real scenarios with AgiMate Desktop

Document processing

New file in Downloads → AI recognizes document type → extracts data → uploads to 1C or CRM.

New fileAI recognitionUpload to 1C/CRM

AI secretary on PC

AI monitors files and events on the computer, analyzes and categorizes, notifies or acts automatically.

PC eventAI analysisNotification / action

Voice assistant

Critical event → AI evaluates priority → speaks through speakers + shows desktop notification.

Critical eventAI prioritizationTTS + notification

Legacy Software Bridge

AI interacts with desktop apps without APIs — 1C, Excel, specialized software. Bridge between old and new.

AI commandApp actionResult to cloud

Scheduled data collection

Button 'Collect report' → AI gathers data from sources → generates report → notifies when ready.

ButtonAI data collectionReport + notification

Quick commands

Button panel for common operations: 'Create task', 'Send report', 'Check status' — one press launches an AI scenario.

Button pressAI scenarioResult

Under the hood

AgiMate Desktop technical specifications

PlatformsWindows, macOS, Linux
Size~80–100 MB
Server connectionHTTP + WebSocket (Centrifugo)
ProtocolMCP-compatible, n8n node
Auto-reconnectExponential backoff, up to 10 retries
PluginsHot-loading, config validation
Tests313 tests, 97% coverage (core)

Simple and unobtrusive

Lives in the system tray — stays out of your way. All settings in one window.

System Tray

Tray icon with connection status indicator.

  • Connecting... (yellow)
  • Connected (green)
  • Disconnected (gray)
  • Error (red)

General Settings

Tab with server connection parameters.

  • Server address and API key
  • Auto-connect on startup
  • Reconnect interval
  • Device ID and binding status

Plugins Tab

Plugin management and configuration.

  • List of installed plugins
  • Status: active / inactive
  • Enable/disable with one click
  • Settings for each plugin

Get started in 2 minutes

Three simple steps from download to your first trigger

1

Download the app

Choose your platform and download the installer.

2

Configure the connection

Enter the server address and API key in settings. The app will connect automatically.

3

Done!

The agent runs in the background. Enable the plugins you need — and the Desktop agent will start monitoring events and executing commands.

Open Source. Free. Extensible.

Download AgiMate Desktop — add a specialized agent to your computer.