FAQ
常见问题
关于支持范围、自动接入、代理、隐私与平台兼容。
Meowo 支持哪些 AI 编程 CLI？
当前内置支持 Claude Code、Codex、Kimi、Gemini CLI 和 OpenCode。它们各自通过 CLI 的 hook 上报事件，数据写进本地同一份数据库，所以能显示在同一个窗口里。
我的会话数据会上传到云端吗？
不会。数据只写进本地的
~/.meowo/board.db（SQLite）。reporter 和 app 只通过这个本地文件通信，Meowo 不把会话内容发到任何服务器。需要手动配置 hooks 吗？
一般不需要。Meowo 启动时会为检测到的 AI 编程 CLI 接入 reporter，写之前先备份，不会破坏已有配置。需要排查或手动接入时见文档。
这和直接看终端有什么区别？
看终端要你主动切换窗口，还得记住会话位置和不同工具的命令。Meowo 把状态与常用操作放在桌面一角：需要回复时提醒你，点击即可回到、新建或续接会话。
能看到 Agent 的任务进度吗？
能。Agent 用待办工具拆解任务后，对话窗口会实时显示这份清单：正在做哪一条、完成了几条都跟着刷新，不用翻终端输出找进度。待办是增量事件而非快照的 Agent（如当前版本的 Claude Code）暂不显示清单。
Meowo 能帮我省掉哪些命令？
新建会话时直接选择项目目录和 AI 工具；恢复会话时点击卡片即可，不用查会话 ID 或记各工具的续接参数。CLI 安装、登录、hooks 修复和代理设置也提供了界面入口。
代理支持哪些格式，在哪里生效？
可以设置全局默认规则，也可以按 AI 工具覆盖。支持 HTTP、SOCKS5、带用户名密码的 URL，以及
host:port:user:pass。配置会用于 Meowo 的用量查询、CLI 安装和从 Meowo 启动的会话；不同 CLI 的协议与覆盖范围有差异，设置页会显示实际生效情况。点击卡片怎么切到终端的？
连接中的会话会切到它所在的终端标签页（Windows 上是 Windows Terminal，macOS 上是 Terminal 或 iTerm2）。已断开的会话，Meowo 会回到原项目目录，并按对应 AI 工具的方式续接。使用哪个终端可以在设置里指定。
同一个工具能挂多个账号吗？
可以。在设置里为同一个工具添加多个官方账号，每个账号有独立的登录凭据与会话历史，互不影响。点一下即可切换，配额读数和登录状态会跟着当前账号走。
没有官方账号，能用 API 中转吗？
可以。在账号设置里按模型接入 API 中转：填入中转地址、模型名和密钥即可启用，模型名可从推荐项选择或直接填中转商提供的任意 ID。官方账号与 API 中转两种接入方式互斥；配置中转期间仍使用官方账号，用中转时官方配额不适用。
贴纸的外观能改吗？
能。提供 7 种贴纸配色、扁平与立体两种风格、深 / 浅 / 跟随系统三种主题，还能调整不透明度（配合系统毛玻璃透出桌面）和界面密度。改动实时生效，两个窗口一起套用。
支持 Linux 吗？
目前只提供 Windows 和 macOS 的安装包。Linux 打包在计划里，还没做。进展看 GitHub Releases。
会一直占用系统资源吗？
不会。reporter 只在触发 hook 时启动，写完数据库就退出。常驻的只有窗口本身，它靠监听本地文件变化来刷新，开销很小。
免费吗？可以商用吗？
免费，开源，MIT 许可证，可以自由使用和修改。源码见 GitHub。
如何卸载？会残留什么？
按系统常规方式卸载应用。会话数据和应用设置位于
~/.meowo/。如需彻底清理，再从各 AI CLI 的 hook 配置中删除命令包含 meowo-reporter 的条目；不要删除其他自定义 hooks。