The Problem

You use Antigravity, Cursor, Copilot, or Claude Code. You run a task, it takes 3 minutes. You sit there, scrolling through logs, waiting for "FINISHED".

The Solution

Agent Idle Monitor is a lightweight dashboard and desktop widget that tracks all your agents at once. It detects when they finish a thought, hit a breakpoint, or go completely idle, and pings your phone.

Key Features

• Floating Widget: A sleek, glassmorphic HUD that sits on your desktop so you do other things while your agents work.
• Mobile Push Alerts: Instant phone notifications via ntfy.sh.
• Audio Cues: Dashboard "ping" when your agents are waiting for you.
• Unified Logs: Review full prompt/chat/task history from all agents in one beautiful UI.
• Auto-Detection: Works out of the box with your existing IDE configurations.

Installation

# Install globally via NPM
npm install -g agent-idle

# Or run instantly with NPX
npx agent-idle start

Quick Start

1. Start the Monitor

agent-idle start

This automatically launches the Web Dashboard (http://localhost:3001) and the Floating Desktop Widget.

2. Set Up Mobile Notifications

Agent Idle uses ntfy.sh for privacy-friendly push notifications. No account required.

1. Download App: iOS (App Store) / Android (Play Store)
2. Subscribe: When you run agent-idle start, a unique topic URL is displayed in the terminal (e.g., ntfy.sh/agent-idle-xyz).
   • Open the ntfy app, tap +, and enter the topic name.
3. Persistent Config: To use the same topic every time:

   agent-idle config --topic my-secret-project

Supported Agents

| Agent | Integration | Support Level | | :--- | :--- | :--- | | Antigravity | .gemini/antigravity | Full support for task and implementation plan tracking. | | GitHub Copilot | VS Code SQL Storage | Monitors active VS Code sessions. | | Claude Code | CLI & VS Code Logs | Supports both CLI and Extension logs. | | Cursor | SQLite Storage | Activity monitoring with some limitations. |

CLI Usage

Commands

• start: Launches the dashboard and monitoring server.
• config: Manages persistent settings and notification preferences.

Options

| Option | Description | Default | | :--- | :--- | :--- | | --topic <name> | Set the ntfy.sh topic for notifications | Randomly generated | | --idle-timeout <sec> | Inactivity threshold in seconds | 90 | | --notify-mode <any\|all> | Notify on any agent idle, or only when all are idle | any | | --port <number> | Port to run the server on | 3001 |

Configuration Examples

# Set a persistent notification topic
agent-idle config --topic my-project-alerts

# Set a session-specific idle timeout
agent-idle start --idle-timeout 120

# Reset all configuration to defaults
agent-idle config --reset