FAQ
Frequently asked questions
About supported tools, auto-connect, proxies, privacy, and platform support.
Which AI coding CLIs does Meowo support?
Currently Claude Code, Codex, Kimi, Gemini CLI, and OpenCode are built in. Each reports events through its CLI hooks into the same local database, so they all show up in one window.
Is my session data uploaded to the cloud?
No. Data is only written to a local
~/.meowo/board.db (SQLite). The reporter and the app talk only through this local file; Meowo sends no session content to any server.Do I need to configure hooks manually?
Usually not. On startup Meowo wires the reporter into the AI coding CLIs it detects, backing up first so your existing config isn't broken. For troubleshooting or manual setup, see the docs.
How is this different from just watching the terminal?
Watching the terminal means switching windows yourself and remembering each session's spot and each tool's commands. Meowo puts status and common actions in a corner of your desktop: it nudges you when a reply is needed, and one click gets you back, starts, or resumes a session.
Can I see the agent's task progress?
Yes. When the agent breaks a task into steps with its todo tool, the chat window shows the list live — the item in progress and the done count refresh as it works, so you don't have to scroll the terminal output. Agents whose todos are incremental events rather than snapshots (e.g. current Claude Code) don't show a list yet.
Which commands does Meowo save me?
New sessions: just pick a project directory and AI tool. Resuming: click the card — no session IDs or per-tool resume flags to remember. CLI install, sign-in, hook repair, and proxy setup all have a UI too.
What proxy formats are supported, and where do they apply?
Set a global default rule, or override per AI tool. Supports HTTP, SOCKS5, URLs with username/password, and
host:port:user:pass. The config applies to Meowo's usage queries, CLI installs, and sessions launched from Meowo; protocol support and scope vary by CLI, and the settings page shows what's actually in effect.How does clicking a card switch to the terminal?
A connected session switches to the terminal tab it lives in (Windows Terminal on Windows, Terminal or iTerm2 on macOS). A disconnected one has Meowo return to its project directory and resume it the tool's way. You choose which terminal in settings.
Can I keep multiple accounts for one tool?
Yes. Add several official accounts for the same tool in settings; each has its own login credentials and session history, kept separate. Switch with one click and quota readouts and login state follow the current account.
No official account — can I use an API relay?
Yes. Connect an API relay per model in account settings: fill in the relay address, model name, and key to enable it; pick the model from suggestions or enter any ID your relay provides. Official account and API relay are mutually exclusive; you keep using the official account while configuring the relay, and the official quota doesn't apply when the relay is active.
Can I change the sticker's look?
Yes — 7 sticker colors, flat or dimensional styles, and dark / light / follow-system themes, plus opacity (to let the frosted desktop show through) and UI density. Changes apply live, across both windows.
Does it support Linux?
Only Windows and macOS installers are provided for now. Linux packaging is planned but not done yet. Track progress in GitHub Releases.
Does it keep using system resources?
No. The reporter only starts when a hook fires, writes the database, and exits. Only the window stays resident; it refreshes by watching local file changes, at very low cost.
Is it free? Can I use it commercially?
Free, open source, MIT-licensed — use and modify freely. Source on GitHub.
How do I uninstall, and what's left behind?
Uninstall the app the usual way for your OS. Session data and settings live in
~/.meowo/. To fully clean up, also remove entries whose command contains meowo-reporter from each AI CLI's hook config; don't delete your other custom hooks.