Open Source AI Agent Screen Companion

Keep an eye on your AI coding agents.

A desktop screen island for Windows & Linux. Featuring an interactive animated mascot whose eyes track your cursor, one-click terminal permission approvals, live diff re[...]

✓ 100% Free & Open Source ✓ Zero Cloud Telemetry ✓ Works with Gemini CLI, Claude Code, Cursor, Antigravity
Loly is watching your cursor

Move your mouse to watch Loly track your gaze.

Experience the Dynamic Island

Simulate real agent events and permission approvals right inside this browser window.

gemini-cli
Waiting for agent activity...
12:00:00

Simulate Agent Actions

Built-in Focus Lo-Fi Soundscape

Synthesized live via native browser Web Audio API — zero downloads required.

Download Loly Companion v1.0.0

Choose your operating system below for standalone, zero-hassle desktop apps.

Windows

Windows 10 / 11 (64-bit)

  • Portable Executable (.exe) Run instantly without installer (95 MB)
    Download .exe
  • Desktop Setup Installer (.exe) Full desktop installation with Start menu icon (95 MB)
    Download Setup
  • ZIP Package (.zip) Standalone zipped archive
    Download .zip

Linux

Ubuntu 22/24+, Debian, Kali, Fedora, Arch (x64)

  • Universal AppImage (.AppImage) Works on all distributions with or without libfuse2 (120 MB)
    Download AppImage
  • Debian / Ubuntu Package (.deb) Native package installer via dpkg -i (95 MB)
    Download .deb
  • Standalone Tarball (.tar.gz) Direct portable unpack and run (117 MB)
    Download .tar.gz

macOS

macOS 12+ (Apple Silicon & Intel x64)

  • Universal App Archive (.zip) Standalone application bundle (95 MB)
    Download .zip

Built specifically for the agentic coding era.

Everything you need to monitor, control, and collaborate with autonomous AI agents.

👁️

Cursor-Tracking Mascot

Loly's pupils calculate exact angular vectors to watch your mouse cursor smoothly across your screen, reacting to your focus and tasks.

⚡

In-Pill Approvals

Review CLI commands and file diffs without switching terminals. Click Allow, Deny, or Always directly from your screen notch.

✨

Google Gemini Integration

Instant streaming chat powered by Gemini 2.5 Flash, safety command analysis, and drag-and-drop code inspection.

🎵

Procedural Lo-Fi Music

4 built-in focus soundscapes generated directly via Web Audio API. Zero external MP3 files, zero latency, lightweight ambient flow.

🔒

Local SQLite Audit Log

Every agent step, command, approval decision, and chat message is logged in local SQLite (`~/.loly/loly.db`). 100% private.

🔌

Universal Hook Bus

Connects with any agent via Unix domain socket (`/tmp/coucou.sock`), Windows named pipes, or simple HTTP POST requests.

Run with Node.js in 3 Steps

Clone the repository and run Loly directly on your machine.

bash — Terminal
# 1. Clone the repository
git clone https://github.com/PAIN-hub/Loly_Companion.git
cd Loly_Companion

# 2. Install dependencies
npm install

# 3. Start the background server
npm start

# (Optional) Launch the transparent floating Electron island
npm run electron
Free API Access

How to Acquire Your Google Gemini API Key

Google AI Studio provides free Gemini API keys with 1,500 requests/day and no credit card required. Read our complete walkthrough to set up your key in under 2 minutes.