ryanstephen

ryanstephen / lil-agents

Public

tiny AI companions that live on your macOS dock

369
68
100% credibility
Found Mar 26, 2026 at 369 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Swift
AI Summary

lil agents is a macOS application that displays animated walking characters above the Dock, which users can click to open a themed terminal for interacting with local AI coding assistants like Claude, Codex, or Copilot.

How It Works

1
👀 Discover lil agents

You find lil agents, a fun Mac app with tiny animated characters that live right above your dock to help with AI chats.

2
💻 Set up on your Mac

Download the project, open it in Xcode, and run it—your Mac needs Sonoma or newer, and one AI helper tool already installed.

3
😊 Meet Bruce and Jazz

Two cute characters start walking back and forth just above your dock, waving hello on first run with a friendly bubble.

4
💬 Click to chat

Tap Bruce or Jazz, and a stylish terminal window pops up where you type questions to your AI companion.

5
🎨 Customize your style

Use the menu bar icon to pick your favorite AI brain, change themes like Peach or Midnight, or tweak sounds and display.

6
🤖 Get AI help anytime

Ask coding questions, watch thinking bubbles appear with fun phrases, hear a ding when done, and see replies stream in.

✨ Dock buddies for life

Bruce and Jazz become your always-ready, lively AI sidekicks, making your Mac feel fun and productive every day.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 369 to 369 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is lil-agents?

Lil-agents brings tiny AI companions like Bruce and Jazz to your macOS dock, where they walk back and forth just above it using smooth animated videos. Click one to pop open a themed terminal for chatting with Claude Code, OpenAI Codex, or GitHub Copilot via their CLIs—no app switching needed. Built in Swift for macOS Sonoma+, it solves the hassle of firing up separate AI tools mid-coding by keeping everything dock-local and private.

Why is it gaining traction?

It stands out with playful touches like thinking bubbles ("hmm...", "one sec..."), completion sounds, and four themes (Peach, Midnight, Cloud, Moss) switchable from the menubar, turning dry CLI chats into a vibe. Like github tiny c compiler or github tiny shakespeare, it's a compact delight among tiny GitHub projects, but hooks macOS users craving lil agents as tiny companions—think tiny companions poodles reviews for that whimsical, non-intrusive AI access without data leaks.

Who should use this?

macOS developers relying on Claude, Copilot, or Codex CLIs for code reviews, debugging, or quick fixes during terminal-heavy workflows. Solo devs or those in tiny companions kennel-style setups who want AI nudges without bloating their menu bar. Avoid if you're on older macOS or prefer web UIs over local CLIs.

Verdict

Grab it if you're a Sonoma+ CLI AI fan—369 stars and solid README make it easy to build and run via Xcode, with MIT license and Sparkle updates. The 1.0% credibility score flags early maturity (light tests, single dev), but it's stable for personal use and screams potential for dock-loving coders.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.