VibeCat

One bar for every coding agent.

A floating Windows 11 control surface for Claude Code, Codex, Cursor, Aider and friends.
Every live session in one place — pixel-status, hook approvals, terminal teleports.

English · 繁體中文 · 简体中文 · 日本語 · 한국어

---

/ 01 — Four states the cat can hold.

STD #4DD9A8 Idle, watching, fed.

EDIT #4DA8FF Paws on keys, shipping.

ALERT #FFB347 Ear up, needs you.

COMPACT #7B7BD1 Tail flick, compacting context.

A 28×28 procedural pixel cat. Every session in the bar maps to exactly one state — so you read the whole desk in one glance.

/ 02 — What VibeCat does

• One-glance status — STD · EDIT · ALERT · COMPACT map to the agent work you actually care about.
• Sub-50 ms hook decisions — PreToolUse, PermissionRequest, and AskUserQuestion round-trip through a per-session Windows named pipe.
• Live session card per agent — every Claude / Codex / Gemini conversation gets a card with title, terminal, status pill, and elapsed time.
• Native terminal teleport — VibeCat walks the process chain and brings the exact tab/pane forward in Windows Terminal, WezTerm, VS Code, Cursor, ConEmu, JetBrains, or conhost.
• Hook-grade observability — every payload is logged to %LOCALAPPDATA%\VibeCat\logs\ with pid_chain, host_kind, WezTerm pane, console HWND.
• Bring-your-own CLI — set VIBECAT_SESSION_ID, fire SessionStart, your tool gets a card too.
• Private by default — source code, raw logs, prompts, terminal output, license keys, and payment data do not belong in this public repo.

/ 03 — Quick start

1. Download VibeCat from vibecat.app.
2. Install and launch on Windows 11.
3. Connect supported coding tools from the VibeCat integrations panel.
4. Run your agent sessions as usual — each one becomes a card in the bar.
5. For bugs: open Settings → About → Create and Upload Support Bundle, then paste the returned SUP-... ID into the Bug Report form.

/ 04 — Tested with the agents that actually ship.

First-class Hooks bound directly — Pre/Post tool use, permission prompts, AskUserQuestion, prompt-submit, and stop are all routed through VibeCat with a per-launch nonce. Claude Code CLI Codex TUI Gemini CLI

Bring-your-own Anything launched through vibecat-cli gets a session card, status pill, and terminal teleport — without touching the agent's source. Cursor Agent Aider CLI OpenCode · Qwen-Coder · Kimi-Code Generic any

Terminals & IDEs — Windows Terminal (tab-precise) · WezTerm (pane-precise) · VS Code · Cursor · ConEmu / Cmder · JetBrains IDEs · conhost direct.

/ 05 — Public support rules

This repository is public. Keep reports high-level and safe to share.

Important

Do not upload or paste:

• Source code from private repositories
• Private repository links
• Raw logs, prompts, agent replies, terminal output, or command lines
• License keys, API tokens, payment details, email addresses, or other secrets
• Crash dumps or diagnostic reports you have not reviewed locally

For bugs, use VibeCat's Create and Upload Support Bundle action and paste only the returned Support ID into GitHub. Do not attach raw diagnostic files unless support explicitly asks and you have reviewed them locally.

/ 06 — Get help

Channel	Use it for
🐛 Bug report	Reproducible defects with a Support ID.
✨ Feature request	Ideas, product feedback, polish.
🔒 [email protected]	Security, license, billing, anything containing secrets.

---

Made for Windows developers who run more than one coding agent at a time.

_{vibecat.app · © 2026 VibeCat}