Official marketplace for ClawCat - Live2D desktop pet for Claude Code
npx claudepluginhub princessgray/clawcatLive2D desktop pet with Claude Code integration - Visual feedback and interaction overlay
PrincessGrayA Live2D desktop pet that integrates with Claude Code to provide visual feedback and interaction overlay.
中文文档 | English Documentation | Plugin Documentation
# 1. Add the marketplace
/plugin marketplace add PrincessGray/ClawCat
# 2. Install the plugin
/plugin install clawcat
After installation, you need to exit and resume Claude Code to activate the hooks:
# Exit Claude Code
exit
# Resume Claude Code (this activates the hooks)
claude-resume
# Now you can start ClawCat
/clawcat:start
Start ClawCat with a single command:
/clawcat:start
Stop ClawCat when you're done:
/clawcat:stop
That's it! Dependencies will be automatically installed on first start.
If you prefer to run ClawCat directly from this GitHub repo (JS frontend is already bundled, no Node.js required for normal use):
# 1. Clone the repository
git clone https://github.com/PrincessGray/ClawCat.git
cd ClawCat/ClawCatPlugin
# 2. Prepare conda environment:
# The launcher scripts will automatically activate conda 'base' environment.
# If you prefer a dedicated environment, create and activate it first:
conda create -n clawcat python=3.10
conda activate clawcat
# 3. Install Python dependencies (or let the scripts install them on first run)
pip install -r requirements.txt
Then start ClawCat:
Option A: Use the launcher scripts (automatically activates conda base):
scripts\start_window.bat
bash scripts/start_window.sh
Option B: Use your current conda environment (if you've activated a custom environment):
python scripts/service_manager.py start
Note: The launcher scripts (start_window.bat / start_window.sh) will automatically activate conda base environment. If you want to use a custom conda environment, activate it first and then use Option B.
You only need Node.js and npm if you want to develop or modify the frontend; they are not required just to run ClawCat from GitHub.
For detailed documentation, please see:
ClawCat/
├── marketplace.json # Marketplace configuration
├── ClawCatPlugin/ # Plugin directory
│ ├── .claude-plugin/ # Plugin metadata
│ ├── commands/ # Command definitions
│ ├── hooks/ # Hook configuration
│ ├── scripts/ # Python scripts
│ ├── frontend/ # Vue.js frontend
│ ├── src/ # Python backend
│ ├── public/ # Live2D models
│ ├── README.md # English documentation
│ └── README_CN.md # Chinese documentation
├── LICENSE # MIT License
└── IMPLEMENTATION_SUMMARY.md # Implementation details
See the plugin documentation for development instructions.
MIT License - see LICENSE file for details.
This project is inspired by and references the Bongo Cat project. We are grateful to the Bongo Cat community for their creative work and open-source contributions.
Contributions are welcome! Please feel free to submit issues or pull requests.
For issues, questions, or feature requests, please open an issue on GitHub.
Note: This plugin requires Claude Code to be installed and running. It enhances your Claude Code experience with visual feedback but does not modify Claude's core functionality.