From 6ad9ebb99b40145fcfbccf663319e16de3f7c957 Mon Sep 17 00:00:00 2001 From: JohnsonKC201 Date: Fri, 7 Aug 2026 22:10:15 -0700 Subject: [PATCH 1/2] docs: tighten the README into something that reads at a glance The content was already there; the shape was working against it. - The table of contents sat below Quick start, a third of the way down, where a reader who wanted it had already scrolled past. It is now a single compact row under the hero, covering every section rather than the ten it listed. - The two platform callouts were plain blockquotes. They are GitHub alerts now, so the Windows tip and the macOS beta note read as asides instead of body copy. - "What it actually does" was seven long bullets that all started at the same weight, so nothing led. Same seven claims as a table with the hook in the left column, which is scannable in a way the list never was. Two of them also still counted only the cat's 14 coats and named only the meow and the purr. - "Download for Windows" was an H3 acting as a button, which put a fake entry in the heading outline. It matches the hero's badge now. --- README.md | 54 +++++++++++++++++++++++++++++++++--------------------- 1 file changed, 33 insertions(+), 21 deletions(-) diff --git a/README.md b/README.md index 67094e0..dd071d1 100644 --- a/README.md +++ b/README.md @@ -35,8 +35,29 @@ scratch: nearly every sprite, animation, and sound is original and procedural. The browser demo runs the real renderer: pet it, type at it, scroll to climb, and wait for the butterfly. +
+
+ + + Two pets  ·  + In action  ·  + Features  ·  + Quick start  ·  + Meet the cat  ·  + Stay on track  ·  + Controls  ·  + AI agents  ·  + Custom coats  ·  + How it works  ·  + Privacy  ·  + Development  ·  + Contributing + + +--- + ## Two pets, one app Pick your species from the tray (**Pet → Cat / Dog**). Each one keeps its own @@ -94,13 +115,15 @@ pet draws with, generated headlessly by one script. Nothing is a screen recordin ## What it actually does -- It reacts to you. Petting, dragging, typing, scrolling, and cursor play each get their own response, gated by an internal mood model that runs from calm up to zoomies and back. -- 14 coat patterns ship built in, all recolored at draw time from one role-coded sprite, and you can design, import, and export your own. -- Every animation is composed into that sprite, limbs included, so all 28 coats across both species get every pose in their own colours without shipping a single extra frame. -- Every sound is synthesized live with Web Audio: the meow, the purr, the chirp, and an endlessly improvising lo-fi jam. The app ships zero audio files. -- It keeps you on track. Break and Pomodoro timers, repeating reminders, a pinned note, IMAP unread-mail alerts, and calendar nudges, all delivered by your pet. -- It knows when your coding agent is thinking, working, or done, and reacts with its paws. Hook configs ship for five agents. -- The whole thing is a transparent, click-through overlay that stays above every window. Only your pet is clickable. +| | | +|---|---| +| **It reacts to you** | Petting, dragging, typing, scrolling, and cursor play each get their own response, gated by an internal mood model that runs from calm up to zoomies and back. | +| **28 coats, one shape** | 14 cat coats and 14 dog breeds, all recolored at draw time from one role-coded sprite. Design, import, and export your own. | +| **No spare frames** | Every animation is composed into that sprite, limbs included, so all 28 coats across both species get every pose in their own colours without shipping a single extra image. | +| **Zero audio files** | The meow, the bark, the purr, the pant, and an endlessly improvising lo-fi jam are all synthesized live with Web Audio. | +| **It keeps you on track** | Break and Pomodoro timers, repeating reminders, a pinned note, IMAP unread-mail alerts, and calendar nudges, all delivered by your pet. | +| **It watches your agent** | It knows when your coding agent is thinking, working, or done, and reacts with its paws. Hook configs ship for five agents. | +| **It stays out of the way** | A transparent, click-through overlay that sits above every window. Only your pet is clickable. |
@@ -114,7 +137,7 @@ pet draws with, generated headlessly by one script. Nothing is a screen recordin The Windows installer is the easy path. No git, no Node, just run it: -### [Download for Windows](https://github.com/JOhnsonKC201/pixelpets/releases/latest) +[![Download the Windows installer](https://img.shields.io/badge/Download_the_Windows_installer-E8930C?style=for-the-badge&logo=windows&logoColor=white)](https://github.com/JOhnsonKC201/pixelpets/releases/latest) You can also [play with the cat in your browser](https://pixelcat-jet.vercel.app) before installing anything. @@ -131,30 +154,19 @@ Either way your pet appears in the corner and registers itself to start at login `npm run autostart:off` turns that off, and the installed version uninstalls like any other program, from Windows Settings > Apps. +> [!TIP] > **Windows, running from source:** `npm start` leaves a console window open behind > the pet. `launch-pixelpets.vbs` starts the same thing silently, so it works as a > desktop shortcut (point one at `wscript.exe "\launch-pixelpets.vbs"`). It > locates the project from its own path, so moving the folder does not break it. +> [!NOTE] > **macOS (beta):** same commands. On first run, grant Accessibility permission > (System Settings > Privacy & Security > Accessibility) so your pet can react to your > typing and cursor. Input is only detected, never logged or sent anywhere. The mac > port is code-complete but not yet smoke-tested on real hardware; see the > [build checklist](#build-a-standalone-app). Issues welcome. -## Contents - -- [Meet the cat](#meet-the-cat) -- [Stay on track](#stay-on-track) -- [Controls](#controls) -- [AI agent reactions](#ai-agent-reactions) -- [Custom coats](#custom-coats) -- [Build a standalone app](#build-a-standalone-app) -- [How it works](#how-it-works) -- [Privacy](#privacy) -- [Development](#development) -- [Contributing](#contributing) - --- ## Meet the cat From 1c9d8c212f282e5dda7049074cc7e00215d511c4 Mon Sep 17 00:00:00 2001 From: JohnsonKC201 Date: Fri, 7 Aug 2026 22:11:21 -0700 Subject: [PATCH 2/2] docs: keep the section nav from wrapping onto a dangling separator --- README.md | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index dd071d1..18996cd 100644 --- a/README.md +++ b/README.md @@ -39,19 +39,19 @@ scratch: nearly every sprite, animation, and sound is original and procedural.
- Two pets  ·  - In action  ·  - Features  ·  - Quick start  ·  - Meet the cat  ·  - Stay on track  ·  - Controls  ·  - AI agents  ·  - Custom coats  ·  - How it works  ·  - Privacy  ·  - Development  ·  - Contributing + Two pets · + In action · + Features · + Quick start · + Meet the cat · + Stay on track · + Controls · + AI agents · + Custom coats · + How it works · + Privacy · + Development · + Contributing