freshcrate
Skin:/
Home > AI Agents > pincer

pincer

A fast multi-platform agent monitoring utility

Why this rank:Recent releaseHealthy release cadenceStrong adoption

Description

A fast multi-platform agent monitoring utility

README

Pincer Icon

Pincer

Desktop monitoring for local AI agents.
Check health, status, and charts from your system tray, without leaving your workflow.

Changelog ยท Report Bug ยท Request Feature

Status Release Platform License

โšก Quick Start

git clone https://github.com/mariodian/pincer.git
cd pincer
bun install && bun run dev

Pincer will appear in your system tray.

๐Ÿ“‹ Table of Contents

๐Ÿค” Why Pincer?

Running multiple local AI agents means constantly switching between terminals and browser tabs just to check what's healthy and what's not. Pincer lives in your system tray and gives you instant visibility into agent health, status history, and usage charts โ€” no context switching required.

pincer-dashboard

โœจ Features

  • Tray-first visibility: check agent health at a glance from your system tray
  • Real-time monitoring: status indicators for each running agent
  • Charts & history: visualize agent activity and health trends over time
  • Persistent storage: activity logged locally with SQLite via Drizzle ORM
  • Minimal resource usage: local-first, no cloud dependency
  • Cross-platform: runs on macOS, Windows, and Linux
  • Light/dark mode: automatic system theme detection with manual override
  • Agent support: works with OpenClaw, OpenCrabs, and custom agents via HTTP health endpoints

๐Ÿ“ฅ Installation

git clone https://github.com/mariodian/pincer.git
cd pincer
bun install

โœ… Requirements

  • Bun v1.0+
  • macOS 13+, Windows 10+, or Linux (GTK3)
  • Xcode Command Line Tools (macOS only, required for native vibrancy effects)

๐Ÿš€ Usage

# Full desktop dev flow
bun run dev

# Fast renderer iteration with HMR + desktop runtime
bun run dev:hmr

# Production build
bun run build

# Environment-based builds
bun run build:canary
bun run build:stable

โš ๏ธ Known Limitations

  • Native vibrancy and traffic-light customization is macOS-only
  • The custom tray menu is macOS-only; Windows and Linux fall back to the native tray

๐Ÿ”ง Troubleshooting

App won't launch on macOS

If macOS blocks the app from running, run:

xattr -cr /path/to/Pincer.app

HMR not updating in secondary windows

Verify dev windows use http://localhost:5173/... URLs.

Weak vibrancy on macOS

Window blur effects may appear weak if transparency is enabled in system settings. Check System Settings โ†’ Accessibility โ†’ Reduce transparency and disable it for full vibrancy effects.

โค๏ธ Like This Project?

If Pincer is useful to you, consider leaving a star on GitHub and sharing it with others.

Share on X (Twitter)

๐Ÿ’ฌ Contributing

See CONTRIBUTING.md for development guidelines.

๐Ÿ“œ License

MIT. See LICENSE.

๐Ÿ“Œ Credits

Feel free to remove this section. Otherwise, credit is appreciated.

Pincer on GitHub ยท Mario Dian on X

Release History

VersionChangesUrgencyDate
v0.3.9 This release brings improved compatibility with popular local AI tools and makes health monitoring more reliable when agents respond in different formats. ## What's New - **Ollama & LM Studio support** โ€” Pincer now recognizes and monitors Ollama and LM Studio agents out of the box, with correct health-check endpoints and status parsing - **Better health-check resilience** โ€” Agents that respond with plain-text status messages (like Ollama's "Ollama is running") are now handled correctly insteaHigh5/28/2026
v0.3.8 This release improves reliability around incident recovery and daemon synchronization, with a few polish updates to keep day-to-day monitoring more consistent. ## Highlights - Incident recovery is more dependable, so ongoing issues are less likely to be lost after app or sync state transitions - Daemon namespace migration handling is more robust, improving sync continuity in upgraded environments - Tray status synchronization is more consistent with the latest monitored state ## Fixes - FixHigh5/18/2026
v0.3.7 This release improves reliability for upgrades and daemon synchronization. It focuses on correctness fixes without changing core workflows. ## Highlights - Upgrades now apply critical database uniqueness safeguards more reliably - Daemon sync now reports status statistics more consistently ## Fixes - Fixed migration statement formatting so required database indexes are created during upgrade - Fixed sync stats handling to prevent inconsistent status totals **Full Changelog:** https://githuHigh5/3/2026
v0.3.5This release adds Homebrew-aware update instructions and includes cleaner logging and minor reliability improvements. ## Highlights - Homebrew users now see a tailored update command in Settings > About when a new version is available - **Note:** `brew install` instructions will be available starting from the next release ## Fixes - Reduced noisy log output by correcting the log level used for poll completion messages - Added a warning when you start polling with no agents enabled,High4/25/2026
v0.3.4 ### Added - Added linked incident support so related incidents can be connected in incident events. - Added shared logging and database utilities used across desktop and daemon runtimes. - Added daemon lifecycle handling improvements for enabling/disabling daemon mode and syncing state transitions. ### Changed - Updated daemon synchronization architecture with a dedicated daemon client, polling-mode strategy, and more resilient import flow. - Updated incident timeline processing to use pre-aHigh4/24/2026
v0.3.4-dev.1 ### Added - Added root-level daemon development, formatting, typechecking, and bundling scripts so daemon workflows run from the main workspace. - Added shared database core and helper utilities to consolidate SQLite access across the app and daemon codepaths. ### Changed - Updated daemon packaging to use the root workspace dependencies and root package version metadata instead of a separate daemon package manifest. - Updated release automation to bundle the Linux daemon from the root scriptHigh4/20/2026
v0.3.4-dev ### Added - Added daemon synchronization and incident backfill support so the desktop app can recover monitoring gaps after sleep or downtime. - Added Linux daemon release packaging so GitHub releases now publish a `pincerd-vX.Y.Z-linux-x64.tar.gz` bundle. - Added daemon logging controls and release-tagging guidance for validating daemon version metadata before publishing. ### Changed - Updated daemon channel resolution and bundling to derive version and release context more reliably. - RenaHigh4/20/2026
v0.3.3 ### Added - Added Homebrew uninstall instructions to complement the installation flow. - Added additional README screenshots to improve product walkthrough coverage. ### Changed - Updated GitHub Actions workflow permissions to read-only for tighter default security. - Updated macOS troubleshooting instructions for quarantined app launch behavior. ### Fixed - Fixed Linux autostart handling and added BSD support in the autostart flow. **Full Changelog:** https://github.com/mariodian/pincer/High4/18/2026
v0.3.3 ### Added - Added Homebrew uninstall instructions to complement the installation flow. - Added additional README screenshots to improve product walkthrough coverage. ### Changed - Updated GitHub Actions workflow permissions to read-only for tighter default security. - Updated macOS troubleshooting instructions for quarantined app launch behavior. ### Fixed - Fixed Linux autostart handling and added BSD support in the autostart flow. **Full Changelog:** https://github.com/mariodian/pincer/High4/18/2026
v0.3.3 ### Added - Added Homebrew uninstall instructions to complement the installation flow. - Added additional README screenshots to improve product walkthrough coverage. ### Changed - Updated GitHub Actions workflow permissions to read-only for tighter default security. - Updated macOS troubleshooting instructions for quarantined app launch behavior. ### Fixed - Fixed Linux autostart handling and added BSD support in the autostart flow. **Full Changelog:** https://github.com/mariodian/pincer/High4/18/2026
v0.3.3 ### Added - Added Homebrew uninstall instructions to complement the installation flow. - Added additional README screenshots to improve product walkthrough coverage. ### Changed - Updated GitHub Actions workflow permissions to read-only for tighter default security. - Updated macOS troubleshooting instructions for quarantined app launch behavior. ### Fixed - Fixed Linux autostart handling and added BSD support in the autostart flow. **Full Changelog:** https://github.com/mariodian/pincer/High4/18/2026
v0.3.2 ### Added - Added Homebrew installation instructions in README. ### Changed - Enhanced UI component styling with improved shadow treatment and visual polish. - Updated the README features section for clearer wording and structure. - Updated Homebrew tap workflow to support release publishing flow. **Full Changelog:** https://github.com/mariodian/pincer/compare/v0.3.1...v0.3.2 High4/15/2026
v0.3.1 ### Added - Added heatmap component with CSS variable system (`--heatmap` through `--heatmap-5`) for color-coded status visualization. - Added HeatmapCell component with time-period tooltip showing status breakdown (ok/degraded/failed counts). - Added 24h view (144 ten-minute cells) and 7d view (168 hourly cells) for incident heatmap. - Added error intensity formula: `(failed + 0.5 * degraded) / total_checks` for perceptual weighting. - Added horizontal scroll for heatmap grid overflow. ### CHigh4/14/2026
v0.3.0 ### Added - Added `stopStatusUpdates()` export and integrated into quit handler to prevent dangling timers. - Added `internalNetworkWarning` field for agents on private/internal networks with security-conscious user notifications. - Added `Semaphore` class with `MAX_CONCURRENT_HEALTH_CHECKS=10` for concurrency limiting. - Added incident retention with configurable cleanup (`runIncidentRetentionCleanup()`) unified with settings.retentionDays. ### Changed - Wrapped all `parseStatus` functions High4/14/2026
v0.2.0 ### Added - Added Linux tray icon support and updated tray manager behavior for Linux environments. - Added support for Hermes and OpenCode agent types across agent configuration and listing flows. ### Changed - Refactored incident status rendering by removing `CheckDotWithTooltip` to improve renderer performance. ### Fixed - Fixed AgentForm URL input behavior by disabling browser autocomplete and spellcheck. - Fixed OpenClaw default port configuration and aligned OpenCode agent type handlHigh4/13/2026
v0.1.9 ### Added - Added enhanced incident timeline behavior with unified day-level sorting and improved empty-state handling. ### Changed - Refactored status presentation in `CheckDot`, `IncidentBadge`, and `IncidentCard` to use tone-based class handling for more consistent UI states. ### Fixed - Fixed report handling behavior to improve stability in report-related flows. **Full Changelog:** https://github.com/mariodian/pincer/compare/v0.1.8...v0.1.9 Medium4/12/2026
v0.1.8 ### Added - Added incident tracking persistence with new SQLite schema/migration support (`incident_events`) and repository/storage wiring. - Added incident RPC endpoints and main-process services for incident lifecycle handling, grouping, and retention cleanup. - Added reusable UI primitives for incidents, including `Timeline` and `Badge` components. - Added incident-focused renderer components and pages (`IncidentCard`, `Timeline`, `CheckDotWithTooltip`, and Incidents page integration). - AdMedium4/12/2026
v0.1.7 ### Added - Added per-agent uptime reporting with detailed status breakdowns. - Added HTML export functionality for uptime reports. - Added shared time range helpers and formatting utilities for consistent report data handling. - Added a reusable table component for structured data display. ### Changed - Refactored report generation by moving HTML export logic to a dedicated service. - Refactored uptime report components to use shared time range helpers. - Unified status type across agent-reHigh4/9/2026
v0.1.6 ### Added - Added notification settings and management functionality for customizing agent alerts. - Added settings migration for advanced and notification configurations. ### Changed - Enhanced notification logic and batching for improved agent status change handling. - Refactored status update polling to use `setTimeout` for better control and reliability. - Improved code formatting and readability across multiple files. - Simplified notification threshold descriptions for improved clarityMedium4/8/2026
v0.1.5 ### Added - Added stronger validation and error handling in the agent form flow. - Added database migrations to align update-settings schema changes. ### Changed - Updated application UI layout and styling across app shell, navigation, and settings pages for better consistency. - Updated page-header formatting and responsive layout behavior in agent-related views. - Renamed update setting field usage from `autoCheckEnabled` to `autoCheckUpdate` across shared types, RPC, storage, and settingsMedium4/7/2026
v0.1.4 ### Added - Added reusable `seriesDot` and `seriesLine` chart snippets for more consistent series rendering. ### Changed - Refactored `GapAreaChart` and `GapLineChart` to use `LineSpline` and `SeriesDot` components. - Enhanced gap-chart rendering with improved opacity handling, line highlighting, and full-range time-series padding. - Updated `GapLineChart` behavior with improved `xDomainPadding` handling and x-axis configuration. - Updated `GradientBarChart` to use computed gradient stops anMedium4/6/2026
v0.1.3 ### Added - Added a CSS module type declaration to improve TypeScript support for stylesheet imports. ### Changed - Updated tray icon resources and configuration to improve visual consistency. - Refactored code structure in key UI paths for clearer organization and maintainability. ### Fixed - Fixed chart components to read series properties from chart context and handle data more reliably. **Full Changelog:** https://github.com/mariodian/pincer/compare/v0.1.2...v0.1.3 Medium4/5/2026
v0.1.2 ### Added - Added Escape-key shortcuts in the agent form to close discard dialogs and navigate back. - Added keyboard accessibility improvements across controls, including explicit `tabindex` support. - Added a loading spinner in settings to improve feedback during asynchronous states. - Added app state persistence for window bounds and UI preferences. - Added a Windows `icon.ico` asset for platform-specific packaging. ### Changed - Replaced Hugeicons usage with Lucide icons and unified iconMedium4/5/2026
v0.1.1 ### Added - Added update management features and related settings. - Added an `openExternalUrl` RPC method and improved alert components. - Added toast notifications for agent feedback with `svelte-sonner`. - Added a `useNativeTray` setting and updated related components. ### Changed - Updated README content for clarity and additional project details. - Updated changelog tooling rules and release-workflow extraction behavior. - Updated `@hugeicons/core-free-icons` and `tailwindcss` dependencMedium4/3/2026
v0.1.0### Added - **Agent editing:** Implemented save support in the agent form. - **RPC/settings:** Added `maxRequestTime` in shared RPC definitions and implemented `getSettings` handling. - **Observability:** Added broader application logging, including error logging in RPC handlers and status sync. ### Changed - **Routing:** Improved initial-route and pending-route handling to make renderer startup/navigation more reliable. - **UI behavior:** Updated tray interaction so agent clicks opeMedium4/2/2026
v0.0.9### Added - **Dashboard:** New features and visualizations โ€” KPIs, MetricChart, StatusPieChart, GradientBarChart, and related chart improvements for layout and responsiveness. - **UI components:** Added ErrorState, EmptyState, PageHeader, and `KpiCard` variants with gradient and color options. - **Tray & icons:** New tray SVG/resource, updated tray icon path, and removal of obsolete icon resources. - **Settings:** Added `showDisabledAgents` to control visibility of disabled agents. - **BuMedium3/31/2026

Dependencies & License Audit

Loading dependencies...

Similar Packages

Paper2Slides๐Ÿ“Š Transform research papers into professional slides and posters seamlessly and quickly with Paper2Slides, saving you valuable time.main@2026-06-06
AgentWardAgentWard โ€“ Built for all, hardened for OpenClaw.main@2026-06-04
Auto-UseAuto-Use Computer Use โ€” drives your OS, browser, scours the web, writes your code. One agent, end to end.v1.3
Multi-Agent-AI-Travel-AdvisorAI travel planner with 7 specialized agents, RAG, and tool-calling. Built with CrewAI & LangChain. Generates personalized itineraries with flights, hotels, activities, and cultural tips. Production-remain@2026-04-12
uix-ai-agent๐Ÿค– Generate UI & UX flows for web and mobile apps using natural language prompts with UIX AI Agent, your intelligent design assistant.main@2026-06-07

More in AI Agents

hermes-agentThe agent that grows with you
awesome-copilotCommunity-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.
e2bE2B SDK that give agents cloud environments
letta-codeThe memory-first coding agent