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:

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.