# ryanstephen/lil-agents

tiny AI companions that live on your macOS dock

Repository: https://github.com/ryanstephen/lil-agents
Canonical: https://ross.abutalabs.com/products/lil-agents
Language: Swift
License: MIT
License Family: permissive
Last push: 2026-04-06T02:34:45+00:00

## Health v2 (maintenance only)
Score: 63/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 75, release rhythm 78, longevity 11
- inputs: {"age_days": 163, "days_push": 150, "days_rel": 150, "gap_med": 3, "n_releases_24m": 4}
- flags: young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1441, forks 278 (observed 2026-08-28T04:04:44.397501+00:00)

## What it is
A macOS app that renders tiny animated AI companions walking above your dock, which you can click to open a themed popover terminal for chatting with AI coding CLIs. It supports Claude Code, OpenAI Codex, GitHub Copilot, and Google Gemini CLIs, switchable from the menubar.

## Use cases
- run AI coding assistants in a fun dock companion
- chat with Claude Code or Gemini CLI from a popover terminal
- add animated AI pets to my macOS dock
- switch between multiple AI coding CLIs in one app
- keep an AI agent visible while it works with thinking bubbles

## When to choose
- you use macOS Sonoma or later and want a playful AI assistant UI
- you already use one or more AI coding CLIs and want a unified front-end
- you value local privacy - the app itself collects no data

## When to avoid
- you need a full-featured standalone AI chat client without external CLIs
- you're on Windows or Linux
- you want a headless or scriptable agent framework rather than a GUI toy

## Facets
- artifact type: application
- maturity: active
- function: chatbot, chat-interface, agent-framework, terminal-ui, animation
- domain: artificial-intelligence, desktop-applications, developer-tools, entertainment
- platform: -
- tags: ai-companions, dock-pets, cli-wrappers, menubar-app, sparkle-updates, ai-agents, macos, desktop, swift

## Member repositories
- ryanstephen/lil-agents (main) score 63

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:44.397501+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:36:29.322898+00:00, confidence not recorded.
  - readme: https://github.com/ryanstephen/lil-agents (fetched 2026-08-28T04:04:44.397501+00:00, sha b2a770f9f6a8)
- Data as of 2026-08-30T08:39:29.467469+00:00.