oh-my-petcare

Oh My Petcare

An AI notebook for cat & dog parents. It keeps notes for the ones who can't speak up, helps you catch the small stuff early, and nudges you when something's due. No diagnosis, no prescriptions. Just careful records, quietly looking out for them their whole life.

Small affair, Big care

English · 简体中文

What is this

This repository ships two AI skills, oh-my-catcare (cats) and oh-my-dogcare (dogs), under the project name oh-my-petcare.

Think of it as a pocket AI notebook for pet parents, except this one does its own work. Say something and it files it away. When a shot or a deworming is due, it reminds you. When it's time to see the vet, it has your sheet ready. You jot things down, track expenses, keep profiles, and pull a clean one-pager for your vet or sitter whenever you need one.

Put plainly, the one thing it most wants to fix is this: that fluster at the vet's when you can't get the words out. It turns it into a single sheet your vet can read in 30 seconds. The notes, the reminders, the exports: they all grew out of that one problem.

One thing to be clear about up front: it is not an AI vet. It keeps your information tidy and organized. It never diagnoses, and never gives treatment or medication advice. There's exactly one time it speaks up: when red-flag signs show up, it tells you to get to a clinic, fast. But it's pushing you toward the action ("you should go now"), never naming the illness. Diagnosing is always the vet's job.

Why I built it

The hardest part of having pets isn't the big life-or-death stuff. It's the endless, crumb-sized daily details that slip your mind: when was the last vaccine or deworming? What food did we switch to last month? The cat's peeing outside the box again, and where do I even start? How do I brief the friend feeding them while I travel? Keep all this in your head or scattered across chat history, and it turns to chaos sooner or later.

But the moment that actually made me build it was a more gut-wrenching one:

You take them to the vet, you freeze, and every odd little thing you noticed all week is just… gone. You mumble, the vet asks three questions and you can't answer two. On the drive home it hits you: "right, the other day they also…"

That feeling of knowing your pet better than anyone, yet being useless in the one moment that counts, is what this notebook is really for. Jot a note a day, and you won't freeze at the vet's. It holds your scattered observations, tidies them up, and turns them into a sheet the vet can actually read. A quick note a day keeps the panic away.

What it can do

🩺 The core: being your vet-visit helper

Your everyday observations matter most at the vet's, and that's exactly where people freeze. This is what it's built for:

• turns your scattered, flustered symptom notes into a chief-complaint summary your vet can read in 30 seconds;
• transcribes paper lab reports line by line for your records, so a lost or faded original won't cost you;
• urges you to get to a clinic fast when red-flag signs appear (it urges; the judgment always belongs to the vet);
• after the visit, organizes the prescriptions into a clear medication schedule.

Everything else here exists to serve that one moment: being able to help when it actually counts.

Everything else it lends a hand with

From everyday feeding and cleanup to the occasional scramble, it handles the routine stuff too:

• Quick notes & pet profiles: store breed, vaccines, allergy history, and your go-to vet. Mention weight, appetite, or litter-box updates anytime, and it files them and tracks trends.
• Care & behavior: cat issues like inappropriate urination, stress, scratching, or multi-cat conflict; dog walk logs and positive-reinforcement training. It can also read pet-food ingredient labels for you (purely as a favor: no affiliate links, no brand deals, ever).
• Reminders pushed to your phone: deworming, vaccines, restocking, birthdays, all organized into one schedule. On resident AI agents like OpenClaw or Hermes, with your authorization it can push reminders straight to your WeChat or Telegram; on regular chat agents, it brings things up when you talk to it.
• Travel & handover: packing lists for trips with pets, handover guides for sitters, beginner handbooks, even keepsake growth cards.
• One record, shaped for whoever's reading it: the vet's copy is clean and serious (chief-complaint sheet, lab transcript, recheck list, ledger-style weight trend), so it reads in 30 seconds with nothing to trip over. The copy for yourself runs warm instead (cozy receipt, pet profile card, growth memorial card, colorful weight trend), the kind of thing you'll actually keep or share. Same underlying data, two very different lives. Both export as a mobile long image or a printable A4 PDF.
• Chinese / English / Traditional Chinese: every export can switch between Simplified, English, and 繁體, all within one file. Handy for vet visits abroad or sitters in different regions.
• Your data stays yours: everything is stored locally as markdown under ~/.petcare/. Copy it, back it up, move it. No cloud lock-in, no server to worry about shutting down.

This is a living project. It was first written for my own two dogs, and I use it myself, so it grows new templates and scenarios as real needs come up. It's not a product with a roadmap; it's a notebook that keeps growing. (Maintained in spare time, so just don't expect a developer on a KPI.)

A look at what comes out

Same underlying records, shaped two ways — a serious copy for the vet, a warm one for yourself. All examples use sample data.

Thumbnails show the top of each note — click any to open the full-length image.

→ See all 20 templates in the full gallery.

What it firmly refuses to do (hard lines)

• No diagnosis, no prescriptions. The only exception: faithfully transcribing a medication list your vet has already prescribed, nothing added, nothing removed.
• No replacing professionals. It does not stand in for a veterinarian or a dog trainer.
• Strict neutrality. No herbal-remedy suggestions, no product placement, no brand recommendations.
• Hands off your local files. It never touches your records without your explicit confirmation.

Full disclaimers live in DISCLAIMER.md inside each skill.

Where it runs

Works in Claude Code, Codex, Cursor, Antigravity, and resident AI agents like OpenClaw/Hermes.

It degrades gracefully based on what your AI agent can do:

• can write files → outputs .html;
• has a browser/screenshot tool → generates PNG/PDF automatically;
• chat-only → prints HTML code for you to save;
• resident agents get proactive push reminders; regular ones mention reminders when you chat.

How to use

Option 1: hand the link to your AI agent (easiest)

Just send this project link to whatever AI agent you're using (Claude Code, Codex, and the like) and ask it to install the skill for you:

https://github.com/idonafraid-create/oh-my-petcare

Something like "install this skill for me, I have a cat (or dog)" is enough. It'll pull the repo and drop the skill in the right place.

Option 2: install from the command line

npx skills add idonafraid-create/oh-my-petcare -y -g

-g installs globally for all directories; drop it for the current directory only, and rerun to update.

Or grab the source with git clone:

git clone https://github.com/idonafraid-create/oh-my-petcare.git

Then just talk to it in plain language:

"My cat threw up twice today" "Isn't the dog due for deworming?" "Make me a pet-sitting handover list"

No commands to memorize.

Security notes (for resident-agent users)

The skill never sends your pet records to any server. Your data stays on your own machine under ~/.petcare/. (Exports may fetch public fonts from Google Fonts, and you can let it look things up online, but none of that uploads your private data.) That said, if you run it on a resident AI agent like OpenClaw/Hermes, please secure the machine that agent runs on:

• Never expose the agent to the public internet: no open public ports; use a VPN or an allowlisted tunnel for remote access;
• Configure WeChat/Telegram push channels with least privilege, granting only what reminders need;
• Your pets' records are family privacy. Back them up through channels you trust.

Where your data lives

~/.petcare/
├── memory.md              # household overview (pets, hard rules)
└── cats|dogs/<name>/
    ├── profile.md         # static profile
    ├── timeline.md        # symptoms, checkups, meds, behavior (append by date)
    ├── routines.md        # daily routines & care rhythm
    ├── behavior.md        # behavior & stress log
    ├── vet.md             # visit records & pre-visit prep
    ├── reminders.md       # reminders
    └── supplies.md        # restock list
    # dogs also get training.md (training log)

Maintenance

This is a personal project, maintained in spare time by a pet parent with two beloved dogs. This notebook was first written for the two of them. I'll do my best with bugs, issues, and PRs, but there is no SLA, so thanks for your patience. Please search existing issues before asking.

Credits

Visual design references the open-source projects Kami, beautiful-html-templates, and animal-island-ui (MIT), whose confetti dividers, wave SVGs, and warm design language are borrowed by the self-built skins. Fonts: Alimama FangYuan for Simplified Chinese (Alibaba's free-commercial license); Huninn for Traditional Chinese (a Sethen-derived face, OFL); Nunito and several Google Fonts families for Latin (Bodoni Moda, Space Grotesk, Fraunces, Quicksand, etc., all OFL). All fonts are free for commercial use.

License

MIT.

Author

JollyJOJO (Xiaohongshu) / idonafraid-create (GitHub) Project: https://github.com/idonafraid-create/oh-my-petcare

This notebook stays free, and it'll keep looking after you and your little one either way. If it ever saves you some worry and you feel like it, you can buy me a coffee. It would make my day.