Cc Pets

CC Pets

English | [简体中文](./README.zh-CN.md)

A native macOS desktop pet for Codex CLI and Claude Code CLI. CC Pets runs without either desktop app and reads five-hour and weekly quota data from local Codex sessions and Claude Code's official status line input.

The application UI and the screenshots below are currently in Simplified Chinese. English UI localization and English screenshots are planned for v2.1.0.

Screenshots

Subscription view	API usage view

Features

• Starts with Codex CLI or Claude Code CLI and closes after the last managed CLI exits.
• Shares one pet across multiple simultaneous Codex and Claude sessions.
• Shows five-hour and weekly remaining quota, reset times, local token totals, and seven-day trends.
• Converts reset times to the Mac's current system time zone.
• Responds to thinking, tool, approval, subagent, completion, and failure events.
• Displays a redacted glass status card with the active CLI session count.
• Supports optional local quota history and macOS notifications.
• Supports third-party CLI agents through a provider event protocol.
• Includes editable global and per-pet speech.
• Includes one original pet and can download compatible assets from PetDex.
• Uses native AppKit with no Electron runtime.

Requirements

• macOS 13 or later
• Node.js 18 or later
• Codex CLI and/or Claude Code CLI installed and signed in
• zsh
• Xcode Command Line Tools (xcode-select --install)

Installation

Install from npm

npm install -g cc-pets@latest --allow-scripts=cc-pets
# Open a new terminal after the first installation.
codex
# or
claude

The `--allow-scripts=cc-pets` option allows recent npm versions to run the package's `postinstall`. That step builds the native app, installs both hook integrations, config