一天一个开源项目（第63篇）：lil agents - 住在 macOS Dock 上的迷你 AI 伙伴

引言“Tiny AI companions that live on your macOS dock.”这是「一天一个开源项目」系列的第 63 篇文章。今天介绍的项目是lil agentsGitHub。很多人把 AI 编程助手放在 IDE 里Cursor / VSCode 插件或者放在终端里Claude Code / Codex / Gemini CLI。但有时候你只想“随手点一下就能问一句”而不是切窗口、开新 Tab、找对命令。lil agents的思路很轻把两个小角色Bruce / Jazz放在macOS Dock 上方来回走动点击角色就弹出一个带主题的 AI 终端并且能在menubar里一键切换不同的 AI CLIClaude、Codex、Copilot、Gemini。它更像一个“桌面小挂件”不替代你现有的 CLI而是把它们变得更“随手可用”、更有情绪价值。你将学到什么lil agents 的产品定位用“桌面角色 popover 终端”把 CLI 体验变轻支持的 AI CLIClaude Code / OpenAI Codex / GitHub Copilot CLI / Google Gemini CLI 的切换方式交互细节主题、slash commands、复制按钮、thinking bubbles、音效、onboarding隐私与边界本地运行、对话由所选 CLI 进程处理、更新机制会发送哪些信息面向开发者的构建方式Xcode 打开工程直接运行前置知识你在 macOS 上使用过至少一种 AI CLIClaude Code / Codex / Copilot / Gemini CLI了解基本的终端安装方式npm / brew / curl 脚本如果要自己构建会用 Xcode可选项目背景项目简介lil agents是一个 macOS 应用在 Dock 上方渲染两个小角色让你通过点击角色打开一个“AI 终端 popover”。它不直接提供模型服务而是把你本机安装的 AI CLIClaude Code、Codex、Copilot CLI、Gemini CLI作为后端能力提供更轻便、更具玩味的桌面交互方式。从 README 的措辞你能明显感觉到它在追求一种体验角色会走路、会“思考”、会“vibe”。对很多开发者来说这类“轻交互 低打断”的工具反而更容易融入日常。作者/团队介绍作者Ryan Stephen仓库维护者项目数据⭐ GitHub Stars: 909 Forks: 0以 GitHub 页面展示为准 版本持续更新中以 Releases 为准 License: MIT 官网/下载https://lilagents.xyz主要功能核心作用把“终端里的 AI CLI”变成“随手点一下就能聊的桌面组件”Dock 上方常驻小角色在 Dock 上方行走存在感很轻点击即用点击角色弹出 AI 终端 popover带主题多 CLI 一键切换Claude / Codex / Copilot / Gemini 在 menubar 切换补齐交互细节slash commands、复制按钮、thinking bubbles、音效、onboarding使用场景碎片化提问写代码时突然想问一句 API 用法/报错含义点一下就问不用切到大窗口。多模型/多 CLI 对照同一个问题在 Claude Code / Codex / Gemini 上各问一次快速对比输出风格。把“状态”做得更可感知thinking bubbles 音效让“AI 在工作”这件事更具反馈感。轻量桌面工作流你不想把聊天塞进 IDE也不想一直开终端窗口popover 形态很合适。快速开始先安装任意一个支持的 CLI至少一个。以下命令来自项目 README# Claude Codecurl-fsSLhttps://claude.ai/install.sh|sh# OpenAI Codexnpminstall-gopenai/codex# GitHub Copilot CLIbrewinstallcopilot-cli# Google Gemini CLInpminstall-ggoogle/gemini-cli然后在https://lilagents.xyz下载 macOS 版本并运行。核心特性Dock 上的动画角色透明 HEVC 视频渲染动画角色走动自然且不占太多 UI 空间。Popover 终端交互点击角色打开一个带主题的 AI 终端 popover。Menubar 切换引擎在 Claude、Codex、Copilot、Gemini CLI 之间一键切换。主题系统Peach、Midnight、Cloud、Moss 四种视觉主题。Slash Commands在输入框支持/clear、/copy、/help。复制体验优化标题栏提供“复制上一条回复”按钮。反馈与情绪化细节thinking bubbles工作时的气泡短句 完成音效 首次引导。自动更新通过 Sparkle 实现自动更新。项目优势对比项lil agents纯终端 CLIIDE 内置聊天入口成本✅ 点击即聊⚠️ 需要切到终端/命令✅ 快捷键/面板打断程度✅ 低popover⚠️ 中窗口/Tab⚠️ 中IDE 焦点变化多 CLI 切换✅ menubar 一键⚠️ 手动切换命令/环境⚠️ 受 IDE/插件限制情绪化反馈✅ 角色/气泡/音效❌ 基本没有⚠️ 有但偏严肃隐私边界✅ 本地 App不收集项目数据✅ 依 CLI 而定⚠️ 依产品实现而定为什么选择它你已经在用 AI CLI但想要一个更“随手”的入口你需要快速切换不同 CLI/模型对照输出你喜欢“轻工具 轻交互”的桌面工作流项目详细剖析交互设计把 CLI 变成桌面小挂件lil agents 的关键不在于“又一个 Agent 框架”而在于把交互入口做到了 Dock 附近Dock 是 macOS 用户最频繁扫视的位置之一角色动画提供了“在线/工作”的存在感popover 让对话不抢占屏幕主空间依赖策略本机 CLI 作为能力层它支持的不是“某个模型”而是“某类 CLI”Claude Code安装脚本OpenAI Codexnpm 全局包GitHub Copilot CLIbrewGoogle Gemini CLInpm 全局包这种设计的好处是lil agents 不需要管理 provider API key 的差异化逻辑至少对外表现如此而是把“对话”和“鉴权/计费/条款”交回给你选择的 CLI 与 provider。隐私与数据边界项目在 README 中明确了隐私边界应用本身不收集/上传你的项目数据、文件路径或聊天内容对话由你选择的 CLI 进程处理发送给 provider 的内容遵循各自条款更新检查通过 Sparkle仅发送 app 版本与 macOS 版本如果你在团队环境落地建议把“各 CLI 的企业合规要求”和“provider 侧的数据策略”单独作为评估项。构建方式项目提供了非常直接的开发者路径用 Xcode 打开lil-agents.xcodeproj点击 Run 即可。项目地址与资源官方资源GitHub: https://github.com/ryanstephen/lil-agents下载/官网:https://lilagents.xyzIssue Tracker: https://github.com/ryanstephen/lil-agents/issues相关资源Claude Code: https://claude.ai/downloadOpenAI Codex: https://github.com/openai/codexGitHub Copilot CLI: https://github.com/github/copilot-cliGoogle Gemini CLI: https://github.com/google-gemini/gemini-cli适用人群想把 AI CLI 变成“随手点一下就能用”的 macOS 开发者喜欢桌面小工具、状态可视化与轻交互的用户需要在多个 AI CLI 之间快速切换、对照输出的重度使用者欢迎来我中的个人主页找到更多有用的知识和有趣的产品