whatisgithub

What is aemeath_withclaude?

77wilnd/aemeath_withclaude — explained in plain English

Analysis updated 2026-05-18

77RustAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A fan made animated desktop pet that reacts live to what Claude Code is doing, running or celebrating in sync with your AI coding session.

Mindmap

mindmap
  root((aemeath-claude))
    What it does
      Animated desktop pet
      Reacts to Claude Code events
      15 animation states
      Speech bubble notifications
    Tech stack
      Rust
      Tauri
      MCP protocol
      Web frontend
    Integration
      HTTP hooks port 9527
      MCP server port 9528
      Claude Code settings
    Audience
      Claude Code developers
      Fans of the character asset

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Add a playful animated status indicator to your desktop while coding with Claude Code.

USE CASE 2

See at a glance whether Claude is reading files, writing code, running commands, or waiting for permission.

USE CASE 3

Learn how to wire Claude Code's HTTP hooks and MCP server into a custom desktop app.

What is it built with?

RustTauriMCPHTML/CSS/JS

How does it compare?

77wilnd/aemeath_withclaudeazw413/glassgradium-ai/gradbot
Stars777974
LanguageRustRustRust
Setup difficultymoderatemoderate
Complexity3/54/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Windows only, requires a Rust toolchain and Node.js if building from source instead of using the packaged .exe release.

The README does not state a license for this repo itself, though the character sprite assets are credited as MIT licensed from a separate source.

So what is it?

This project is a fan made desktop companion character that reacts in real time to whatever the Claude Code AI assistant is doing. When Claude reads a file, the animated character runs, when it writes code, the character enters a building animation, when it finishes a task, the character celebrates. The idea is to give AI coding sessions a lively visual companion sitting on your desktop. The pet is built as a Tauri desktop application, which packages a Rust backend and a web based front end into a native Windows app. The character sprite is pixel art based on a character from the game Wuthering Waves, reused under an MIT licensed asset source, the project notes it is a fan made pet, not an official game or Wuthering Waves product. Two local servers run in the background: one on port 9527 receives HTTP hook notifications from Claude Code each time it takes an action, and another on port 9528 handles richer two way communication through the MCP protocol. A Rust state machine translates these signals into one of 15 animation states and shows them through a transparent, always on top, draggable window with no title bar. The app also lives in the system tray, and the character waves and shows a speech bubble when Claude Code needs your permission for something. This is aimed at developers who use Claude Code and want a playful, animated status indicator that shows at a glance what the AI is currently doing. It requires Windows 10 or later, plus a Rust toolchain and Node.js if you want to build it from source rather than use the packaged release.

Copy-paste prompts

Prompt 1
Walk me through setting up this pet's HTTP hooks in ~/.claude/settings.json and its MCP config in ~/.claude/.mcp.json.
Prompt 2
How do I build the Tauri and Rust backend for this Claude Code desktop pet from source on Windows?
Prompt 3
Explain how the Rust state machine maps Claude Code tool events like Read, Write, and Bash to the pet's 15 animation states.
Prompt 4
What ports does this project use for the HTTP hook server and the MCP server, and what does each one do?

Frequently asked questions

What is aemeath_withclaude?

A fan made animated desktop pet that reacts live to what Claude Code is doing, running or celebrating in sync with your AI coding session.

What language is aemeath_withclaude written in?

Mainly Rust. The stack also includes Rust, Tauri, MCP.

What license does aemeath_withclaude use?

The README does not state a license for this repo itself, though the character sprite assets are credited as MIT licensed from a separate source.

How hard is aemeath_withclaude to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is aemeath_withclaude for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.