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

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

Pincer will appear in your system tray.

• ⚡ Quick Start
• 🤔 Why Pincer?
• ✨ Features
• 📥 Installation
  • ✅ Requirements
• 🚀 Usage
• ⚠️ Known Limitations
• 🔧 Troubleshooting
• 💬 Contributing
• 📜 License
• 📌 Credits

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.

• 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

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

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

# 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

• 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

If macOS blocks the app from running, run:

xattr -cr /path/to/Pincer.app

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

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.

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

See CONTRIBUTING.md for development guidelines.

MIT. See LICENSE.

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

Pincer on GitHub · Mario Dian on X