Skip to content

ryanstephen/lil-agents

Repository files navigation

lil agents

lil agents

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.

Download for macOS · Website

features

  • 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, /help in the chat input
  • Copy last response button in the title bar
  • Global hotkey ⌘⇧Space to 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

requirements

  • 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:

building

Open lil-agents.xcodeproj in Xcode and hit run.

privacy

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.

license

MIT License. See LICENSE for details.

About

tiny AI companions that live on your macOS dock

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors