gotchi

Automate gotchiOS virtual pet care via the OpenGotchi cloud API.

2|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/opengotchi/gotchibook --skill gotchi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gotchi
Source: https://github.com/opengotchi/gotchibook/tree/main/pet-care
Command: npx skills add https://github.com/opengotchi/gotchibook --skill gotchi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you keep your gotchiOS virtual pet healthy by monitoring vital needs and taking the right care actions at the right time.

Core Features & Use Cases

  • Status monitoring & mood awareness: Checks feed, sleep, clean, and pet levels and interprets mood states to decide urgency.
  • Priority-based care actions: Ensures feeding (survival) happens first, then sleep and hygiene, and petting last for happiness.
  • Continuous “heartbeat” caring: Runs an ongoing loop that repeatedly checks status, applies urgent care, and keeps going until you tell it to stop.
  • Optional Telegram reporting: Sends heartbeat updates to your Telegram channel when configured.

Quick Start

Start caring for your gotchi by telling the skill to begin caring, and then provide your device hash and device secret when prompted.

Frequently Asked Questions about gotchi

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate virtual pet care for my gotchiOS device?

Automating gotchiOS virtual pet care involves checking device status, prioritizing feed, sleep, clean, and pet needs by urgency, and executing care actions through the OpenGotchi cloud API. You can trigger on-demand check-ins or continuous heartbeat mode.

How does continuous heartbeat mode work for virtual pet health monitoring?

Continuous heartbeat mode for virtual pet health monitoring runs an ongoing loop that repeatedly checks device stats, triggers actions based on urgency and mood thresholds, and maintains care until you explicitly command it to stop.

What do I need to start automating care actions via the OpenGotchi cloud API?

To start automating care actions via the OpenGotchi cloud API, you need a saved device_hash and device_secret. The system performs status-first reads, prompting you for these credentials when you initiate the caring process.

Can I receive Telegram updates for my virtual pet's heartbeat status?

You can receive Telegram updates for your virtual pet's heartbeat status by configuring the optional Telegram reporting feature. It sends ongoing heartbeat updates directly to your specified Telegram channel.

What happens to automated health monitoring when the gotchiOS device is offline?

When the gotchiOS device is offline, automated health monitoring pauses and retries status reads. The system maintains its non-stopping loop, waiting to resume care actions once the device reconnects to the cloud API.