Tiny AI companions that live on your macOS dock.
Bruce and Jazz walk back and forth above your dock. Click one to open an AI terminal. They walk, they think, they vibe.
Supports Claude Code, OpenAI Codex, GitHub Copilot, and Google Gemini CLIs — switch between them from the menubar.
- Animated characters rendered from transparent HEVC video
- Click a character to chat with AI in a themed popover terminal
- Switch between Claude, Codex, Copilot, and Gemini from the menubar
- Seven visual themes: Peach, Midnight, Cloud, Moss, Neon, Sunset, Aurora
- Slash commands:
/clear,/copy,/helpin the chat input - Copy last response button in the title bar
- Global hotkey
⌘⇧Spaceto instantly open a character from anywhere - Thinking bubbles with playful phrases while your agent works
- Sound effects on completion
- First-run onboarding with a friendly welcome
- Auto-updates via Sparkle
- macOS Sonoma (14.0+) — including Sequoia (15.x)
- Universal binary — runs natively on both Apple Silicon and Intel Macs
- At least one supported CLI installed:
- Claude Code —
curl -fsSL https://claude.ai/install.sh | sh - OpenAI Codex —
npm install -g @openai/codex - GitHub Copilot —
brew install copilot-cli - Google Gemini CLI —
npm install -g @google/gemini-cli
- Claude Code —
Open lil-agents.xcodeproj in Xcode and hit run.
lil agents runs entirely on your Mac and sends no personal data anywhere.
- Your data stays local. The app plays bundled animations and calculates your dock size to position the characters. No project data, file paths, or personal information is collected or transmitted.
- AI providers. Conversations are handled entirely by the CLI process you choose (Claude, Codex, or Copilot) running locally. lil agents does not intercept, store, or transmit your chat content. Any data sent to the provider is governed by their respective terms and privacy policies.
- No accounts. No login, no user database, no analytics in the app.
- Updates. lil agents uses Sparkle to check for updates, which sends your app version and macOS version. Nothing else.
MIT License. See LICENSE for details.