Irrlicht / site

# Irrlicht

> A free, open-source macOS menu bar application that monitors AI coding agent sessions in real time.

Irrlicht provides menu-bar telemetry for AI coding agents like Claude Code, OpenAI Codex, and Pi. It uses a light system — working (purple), waiting (orange), ready (green), error (red) — to show each agent's status at a glance. The app detects sessions automatically via filesystem watching and process scanning, requires zero configuration, and runs entirely on-device with no data leaving the machine. Built with Go and SwiftUI, it supports multi-agent monitoring, context pressure tracking, cost estimation, and git-aware session grouping. MIT licensed.

## Documentation

- [Installation](https://irrlicht.io/docs/installation.html): Install via DMG, PKG, or build from source
- [Quick Start](https://irrlicht.io/docs/quickstart.html): Get up and running in minutes
- [The Light System](https://irrlicht.io/docs/light-system.html): The session states — working, waiting, ready, error
- [State Machine](https://irrlicht.io/docs/state-machine.html): Deterministic session state transitions
- [Session Detection](https://irrlicht.io/docs/session-detection.html): How sessions are discovered and tracked
- [Configuration](https://irrlicht.io/docs/configuration.html): Environment variables and settings
- [Phone Notifications](https://irrlicht.io/docs/elfdans.html): Pair a phone with Irrlicht Elfdans for push notifications via a self-hosted relay
- [Tips & Tricks](https://irrlicht.io/docs/tips-and-tricks.html): Easy-to-miss settings — menu bar styles, quota forecasts, spoken alerts, click-to-jump, usage exports
- [CLI Tools](https://irrlicht.io/docs/cli-tools.html): The irrlichd daemon and irrlicht-ls tool
- [API Reference](https://irrlicht.io/docs/api-reference.html): HTTP and WebSocket API
- [Architecture](https://irrlicht.io/docs/architecture.html): Hexagonal architecture with ports and adapters

## Links

- Homepage: https://irrlicht.io
- GitHub: https://github.com/ingo-eichhorst/Irrlicht
- Download: https://github.com/ingo-eichhorst/Irrlicht/releases/latest
- Changelog: https://irrlicht.io/docs/changelog.html