Clawdex enhances the user experience of Claude Code by introducing a small, interactive companion overlay that responds to various states in the coding process. With effortless installation and full compatibility with existing Codex pets, it provides a novel way to monitor workflow and engage with coding tasks.
clawdex is an innovative companion overlay designed for Claude Code, seamlessly integrating Codex-pet capabilities. By replicating the interaction between Claude Code and Codex pets, clawdex offers a dynamic visual experience directly on the user's screen.
When implemented, clawdex displays a small floating sprite that reacts to the various states of Claude Code, enhancing user engagement. The overlay visually signifies different actions taken by Claude Code:
| Claude Code Action | Pet Response |
|---|---|
| Considering your prompt | Reviewing |
| Executing Bash/Edit/Write Tool | Running |
| Reading or Grepping | Reviewing |
| Requesting Permission | Waiting |
| Completing a Task | Waving |
| Idle | Idle / Blinking |
This interaction is facilitated through Claude Code's hooks and the statusline API, allowing for real-time updates and visual feedback.
Getting Started
The installation process for clawdex is straightforward. The repository provides a simple command to set it up quickly:
brew install danielkempe/clawdex/clawdex
clawdex wake
For those who already own Codex pets located in ~/.codex/pets/, clawdex provides compatibility to drop in and function right away.
Features
- Visual Feedback: Creates an interactive experience with visual cues based on Claude Code's current activities.
- Existing Compatibility: All Codex pets can operate without modifications, significantly reducing setup time.
- Community Resources: Easily acquire pets from petdex, which includes over 467 Codex-compatible options.
Development Environment
For developers interested in contributing or customizing clawdex, a comprehensive development setup is available. Commands for building and running the daemon facilitate smooth testing and integration.
swift build # Builds clawdexd and clawdex
swift run clawdexd # Launch the daemon in the foreground
Documentation
A full overview of state mapping and the underlying architecture can be accessed in the documentation folder, ensuring that developers understand the project's framework and capabilities.
clawdex exemplifies modern pet compatibility within its framework, offering a creative yet functional approach to user interaction with Claude Code.
No comments yet.
Sign in to be the first to comment.