Lucarne

English | 中文

Stop babysitting your local AI agents.

- No new mobile app required; receive timely, secure notifications through existing channels
- Zero-intrusion setup: no hooks, no skills, no MCP, no project changes; scan a QR code and start using it in one step
- Agents run on your local computer, so you can step away while WeChat / Telegram keep you synced on key progress
- Permission approvals, clarifying questions, and failure notifications become actionable mobile events
- Scan a WeChat QR code to receive agent messages; quote a message to continue the matching context automatically
- Use the Telegram console to view all agents, workspaces, and historical sessions
- View local agent session history and agents currently running on this machine
- Lightweight resident process with high performance and low memory use; idle agents are released automatically

Quick Start

1. Install

macOS / Linux:

Windows PowerShell:

Homebrew (recommended) and release archives

Homebrew:

Release archives are also available for macOS, Linux, and Windows on x86_64 and aarch64.

2. Initialize

Initialization guides you through:

- Selecting enabled agents: claude, codex, copilot, gemini, pi, grok (Grok Build)
- Configuring a Telegram Bot Token and an entry chat with Topics/thread mode enabled (optional)
- Logging in to WeChat by QR code (optional)
- Generating the config file: ~/.lucarned/lucarned.yaml

3. Start the background service

Homebrew service commands (recommended)

Platform notes

lucarned autostart uses native user-level service managers:

- macOS: LaunchAgent
- Windows: Task Scheduler logon task
- Linux: systemd user service

Linux autostart requires systemd user services. Non-systemd Linux can run lucarned manually.

4. Open the Telegram panel (optional)

After the…