# Meowsage

> Turn invisible AI coding activity into a pixel-art cat that sleeps, wanders, flops, and sprints across your desktop

- **Status** — Work in progress
- **Category** — Desktop companion for Claude Code + Codex
- **Tags** — Desktop companion, Claude Code + Codex
- **Last reviewed** — 2026-09-08

## Contribution

Built the local activity-reading and calibration system, eight-mood behavior model, and pixel-art desktop experience

## Problem

### Token usage deserved more personality than a dashboard

I wanted a clearer view into token usage, but not another conventional dashboard. Meowsage began as a challenge to turn an invisible technical signal into a unique, delightful companion

> Make coding activity feel alive, not merely measurable

## Approach

### A mood system that learns your rhythm

Meowsage reads local Claude Code and Codex session logs, scores each tool against its own recent history, and lets the busier signal set the cat’s mood. A heavy user and a light user both see the full range—without an account, API key, or network request

## Workflow

**From quiet session to zoomies in one minute**

### 01 — Observe

Reads only local session logs and weights recent output more than cheap cache reads

### 02 — Calibrate

Compares the last 60 seconds with the user’s active minutes from the previous hour

### 03 — Express

Maps the result across eight moods, then adds speech, wandering, zoomies and cursor hunting

## Roadmap

### Make the companion easier to adopt everywhere

- **Perfect every frame** — Regenerate the relaxed blink so only the eyes move between poses

- **Platform confidence** — Validate the full experience on Windows and Linux, beyond the tested cross-platform core

- **Add more skins and pets** — Offer premium skins and new animal companions for a fee

## Run after installation
```sh
meow
```

## Media
- [Primary visual](https://alkal.me/media/playground/meowsage/meowsage-demo-poster.jpg): Meowsage reacting to a coding session by waking up, celebrating, sprinting, flopping, and hunting the cursor
- [Demo video](https://alkal.me/media/playground/meowsage/meowsage-demo.mp4): MP4 demonstration

## Links
- [Canonical case study](https://alkal.me/playground/meowsage)
- [GitHub repository](https://github.com/kalkal87/meowsage)