Desktop Monitor

Monitor AI agent executions, review approvals, and track costs from a lightweight desktop app that lives in your system tray.

Desktop Monitor

PromptRails Monitor is a desktop app for monitoring your AI agent executions in real time. It lives in your system tray and gives you instant visibility into execution status, costs, traces, and pending approvals — without opening a browser tab.

GitHub

Releases

Features

Live Execution Feed — Real-time polling of agent executions with status, duration, and cost
Trace Viewer — Collapsible trace tree with span details, input/output, and token usage
Approval Management — View, approve, or reject pending human-in-the-loop approvals
Native Notifications — Get notified on new approvals and execution failures
System Tray — Quick overview panel on left-click, context menu on right-click
Stats Dashboard — Execution counts, success rates, costs, and top agents with 1D/7D/30D period tabs
Infinite Scroll — Load more executions and approvals as you scroll

Screenshots

Tray Panel

Left-click on the tray icon to see a quick overview of your workspace — execution stats, success rate, cost, pending approvals, and top agents. Toggle between 1D, 7D, and 30D views.

Execution Feed

Browse all agent executions with status badges, duration, cost, and timestamps. Filter by status and scroll to load more.

Stats Dashboard

View execution counts, success rates, total cost, and average duration. See executions-by-day charts and top agents breakdown. Switch between 1D, 7D, and 30D periods.

Approvals

Review pending human-in-the-loop approvals. See checkpoint names, payload data, and approve or reject with an optional reason.

Settings

Configure polling interval (1–10 minutes), toggle notifications for approvals and failures, and disconnect to switch API keys.

Installation

Homebrew (macOS)

brew install --cask promptrails/tap/promptrails-monitor

Direct Download

Download the latest release for your platform:

Platform	Format
macOS (Apple Silicon)	`.dmg`
macOS (Intel)	`.dmg`
Windows	`.msi` / `.exe`
Linux	`.AppImage` / `.deb`

Download from GitHub Releases →

Build from Source

# Prerequisites: Node.js 18+, Rust 1.77+, pnpm 10+
git clone https://github.com/promptrails/desktop.git
cd desktop
pnpm install
pnpm tauri build

Setup

Launch PromptRails Monitor
Enter your API key (pr_...)
Click Connect

The API key is stored securely via the OS keychain. By default, the app connects to https://api.promptrails.ai. For self-hosted instances, click Show advanced options and enter your API URL.

You can create an API key from the PromptRails dashboard under Settings → API Keys. See API Keys and Scopes for details.

Usage

System Tray

The app lives in your system tray:

Left-click — Opens a quick overview panel with stats, pending approvals, and top agents
Right-click — Context menu with "Open Monitor" and "Quit"

Notifications

The app sends native OS notifications for:

New pending approvals — When a human-in-the-loop checkpoint is triggered
Execution failures — When an agent execution fails

Both can be toggled on/off in Settings.

Polling

The app polls the API at a configurable interval (default: 1 minute). Available options: 1 min, 2 min, 5 min, 10 min. Adjust in Settings.

Disconnect

To switch API keys or instances, go to Settings → Disconnect. This clears stored credentials and returns to the setup screen.

Tech Stack

Built with Tauri v2 for a lightweight native shell (~10MB), React 18 + Vite for the frontend, and @promptrails/sdk for API communication.