lil agents
lilagents.xyz- Category
- AI Agents
- Rank
- No. 697Tools index
Previous survey · No. 690 ·
- Pricing
- Free
- Type
- APP
- Builder
- @Ryan__Stephen
- GitHub
- 1.4k stars
- Latest release
- v1.2.2
- Date
About
Tiny AI companions that live on your macOS dock as animated characters you can click to chat with. Supports Claude, OpenAI Codex, GitHub Copilot, and Google Gemini with a playful, themed interface.
What it does
A native macOS front end turns installed coding assistants into a compact desktop chat surface. It detects available providers, launches their command-line processes, parses streamed output and tool activity, keeps conversation history, and presents responses through a themed popover controlled from the menu bar.
Why it's ranked here
The appeal rests on a focused integration, not a new AI backend. Provider adapters translate several incompatible output formats into one interface, while local process handling keeps the app lightweight. The verdict is mixed because convenience comes with broad automatic permissions, home-directory execution, and documentation that understates the implemented provider set.
What's good
Provider detection checks common installation locations and disables unavailable menu choices. The shared message model exposes text, errors, tool use, results, readiness, completion, and process exit events. The interface adds useful small touches: selectable output, Markdown rendering, chat clearing, response copying, themes, display selection, sound controls, onboarding, and automatic updates.
Tradeoffs
Users must install and authenticate a compatible assistant separately. Several adapters grant unrestricted tool permission, and sessions run from the user’s home directory, increasing the consequence of a bad prompt or provider behavior. Codex rebuilds prior conversation into each prompt instead of resuming a native session. The privacy statement also needs qualification because OpenClaw connects to a configured WebSocket gateway.
How to use it well
It suits macOS users who already rely on coding-agent command lines and want quick, casual access without opening a full terminal. Use it for short prompts, status checks, and lightweight coding tasks after reviewing each provider’s permission model. It does not replace an editor, repository browser, provider installation, authentication, or careful supervision of agentic commands.
Technical notes+
LilAgents/AgentSession.swift defines the provider enum, shared message model, availability cache, and AgentSession protocol; it enumerates Claude, Codex, Copilot, Gemini, OpenCode, and OpenClaw. LilAgents/ClaudeSession.swift, LilAgents/CodexSession.swift, LilAgents/GeminiSession.swift, and LilAgents/CopilotSession.swift launch provider binaries with Foundation Process, parse JSONL or NDJSON, and normalize events. Claude uses --dangerously-skip-permissions, Codex uses --full-auto, Gemini uses --yolo, and Copilot uses --allow-all; their working directory is the user’s home directory. LilAgents/OpenClawSession.swift instead uses a WebSocket, token configuration, and persisted Ed25519 device identity. LilAgents/LilAgentsApp.swift builds the accessory app and menu-bar controls, LilAgents/TerminalView.swift implements chat presentation and slash commands, LilAgents/PopoverTheme.swift defines four themes, and LilAgents/DockVisibility.swift decides when characters should appear.
Observed
- License
- MIT License
- Primary language
- Swift
- Platform
- macOS Sonoma 14.0 or later
- Architecture support
- Universal binary for Apple Silicon and Intel Macs
- Packaging and install surface
- Downloadable macOS application; source builds through an Xcode project
- Interface
- Native accessory application with menu-bar controls and popover chat
- Provider transport
- Local command-line subprocess adapters plus an OpenClaw WebSocket gateway adapter
- Update mechanism
- Sparkle automatic updates
Read from README.md, LilAgents/AgentSession.swift, LilAgents/CodexSession.swift, LilAgents/LilAgentsApp.swift, LilAgents/PopoverTheme.swift, LilAgents/TerminalView.swift, LilAgents/ClaudeSession.swift, LilAgents/GeminiSession.swift, LilAgents/CopilotSession.swift, LilAgents/DockVisibility.swift, LilAgents/OpenClawSession.swift.
What it can do
Display animated AI companion characters on macOS dock
macOS system dock → Animated characters (Bruce and Jazz) that walk on the dock
Open AI chat terminal interface
Click on animated character → Interactive chat interface with AI assistant
Generate responses using Claude AI
Text prompts and questions → AI-generated responses and conversations
Generate code using OpenAI Codex
Natural language coding requests → Code snippets and programming solutions
Access GitHub Copilot functionality
Coding queries and development tasks → Code suggestions and programming assistance
Generate responses using Google Gemini
Text prompts and queries → AI-generated responses and information
Tags
Media
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.