> ## Documentation Index
> Fetch the complete documentation index at: https://agent.minimax.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Desktop Pet

> Install and use MiniMax Pet to track visible session progress and answer-needed reminders, and create or import custom pet spritesheets with the bundled Skill.

**MiniMax Pet** is an open-source, lightweight desktop companion Mini App by MiniMax. It summarizes task status, answer-needed reminders, and latest replies across visible conversations in the main window without starting another chat. You can pop it out as a transparent, always-on-top desktop window, switch pets, or use the bundled `minimax-pet` Skill to create and import custom spritesheets. The interface supports Simplified Chinese and English.

* **Open-source repository**: [MiniMax-AI/MiniMax-Code-MiniApps](https://github.com/MiniMax-AI/MiniMax-Code-MiniApps/tree/main/plugins/minimax-ai/minimax-pet) (editable source at [`sources/minimax-ai/minimax-pet`](https://github.com/MiniMax-AI/MiniMax-Code-MiniApps/tree/main/sources/minimax-ai/minimax-pet), MIT License)
* **Requirements**: MiniMax Code **v3.1.6 or later** (**v3.1.11 or later** for **Open conversation**, following the client theme and language, and importing from a Git repository)

## Overview

> [card] [Appearance and switching](#appearance)
>
> Comes with four built-in pets, animation previews, and import/removal for custom spritesheets.

> [card] [Task reminders and open conversation](#tasks)
>
> View recent notices, visible tasks, and Markdown-rendered replies; jump straight to conversations that need your answer.

> [card] [Transparent desktop window](#desktop)
>
> Click **Show on desktop** for an always-on-top transparent window with click-through margins, cursor gaze tracking, and auto-hiding cards.

> [card] [Create pets from a prompt](#custom-pet)
>
> Mention `@minimax-pet` to have the Agent generate and validate a compliant spritesheet ready to import.

## Install and open

> [tab] Plugin marketplace
>
> Search for **MiniMax Pet** in the MiniMax Code plugin marketplace, install it, and confirm the plugin is enabled.

> [tab] Import from a Git repository (v3.1.11+)
>
> In the plugin marketplace, click **Create → Mini App → Import from a Git repository**, paste `https://github.com/MiniMax-AI/MiniMax-Code-MiniApps/tree/main/plugins/minimax-ai/minimax-pet`, verify the requested permission (`session.read`) in **Preview**, and click **Import**.

> [tab] Manual copy
>
> Copy `plugins/minimax-ai/minimax-pet/` from the repository into `<dataDir>/plugins/minimax-pet/` (including the hidden `.minimax-plugin` folder; `<dataDir>` defaults to `~/.minimax`, without the outer `minimax-ai` directory), then restart MiniMax Code and confirm the plugin is enabled.

Once enabled, open **MiniMax Pet** from the Mini App list in a session, or ask the Agent to “打开 MiniMax Pet” (Open MiniMax Pet). Click **Show on desktop** in the top-right corner of the panel to pop out the desktop window.

## Interface and everyday use

The side panel has three tabs—**Appearance**, **Tasks**, and **Settings**. On MiniMax Code v3.1.11 or later, its light/dark theme and default language follow the client automatically.

### Appearance and bundled pets

In **Appearance**, you can preview animations, switch pets, or click **Import pet…** to import or delete custom spritesheets. Four MIT-licensed pets are bundled; v2 pets include 9 animation states and 16-direction cursor gaze tracking:

| Pet name | Layout | Description |
| - | - | - |
| **MiniMax Pet** (default) | v2 | Mint-colored robot |
| **MiniMax Code 章鱼娘** | v2 | Pink-haired coder octopus girl with round glasses and wine-red tentacles |
| **麦芽糖 (Maiyatang)** | v2 | Coral-pink chibi octopus girl with curly hair (contributed by Fectivnfy112357); shows her character bio when selected |
| **MMX 章鱼娘** | v1 | Chibi octopus girl with orange hair, a white vest, and a brown plaid skirt (contributed by antianqi); 9 animations, no mouse-follow |

### Tasks and reminders

The **Tasks** tab filters between **Recent notices** and **All tasks**, showing visible conversations and the selected task's latest reply rendered as Markdown:

* **Needs your answer**: Flagged when a conversation is waiting for your confirmation or questionnaire response.
* **Open conversation / Go answer** (v3.1.11+): Click **Open conversation** (labelled **Go answer** when a response is needed) in a task's detail to bring the MiniMax Code main window forward on that conversation.
* **Mute and clear**: **Mute** on an individual task and **Clear completion notices** in Settings only affect what the pet displays in the current run, without changing task state in the main window.

### Desktop window

Clicking **Show on desktop** switches the pet into a frameless, always-on-top transparent window whose empty areas pass clicks through to windows behind it:

* **Notification cards**: When a task finishes or hits an error, a compact card previews up to 5 lines next to the pet. Click it to read the full reply; opening or closing a card only shows or hides the overlay without resizing or moving the window.
* **Quick actions**: Buttons next to the pet open **Tasks** and **Menu**. From **Menu**, you can view all tasks, change pets, adjust size, or click **Back to panel** to return to the side panel.

### Settings

* **Desktop size**: Choose **Small**, **Medium**, or **Large** for the pet on the desktop.
* **Language**: Defaults to **Follow MiniMax Code**, or pin **简体中文** or **English** (conversation titles and replies stay in their original language).
* **Task notifications**: Seconds before a completed or failed desktop card hides itself (`10` by default; `0` keeps it until closed). **Needs your answer** cards never auto-hide, and hovering pauses the timer.
* **This session's reminders / Task connection**: Restore muted conversations, clear completion notices, or click **Reconnect** if disconnected.

## Create and import custom pets

**1. Generate an atlas with @minimax-pet**

Ask the Agent in chat—for example, “`@minimax-pet` 帮我制作一只桌宠” (“`@minimax-pet` help me create a desktop pet”)—with any character notes, palette, or reference image. The Agent generates `pet.json` and `spritesheet.png` in your workspace and runs the bundled validator to check dimensions, transparency, and grid layout.

**2. Preview animations and import**

Open MiniMax Pet, go to **Appearance → Import pet…**, and select `pet.json` and `spritesheet.png` together. Confirm the 9 animation states in the preview, then click **Import**.

> [accordion] Manual authoring reference: pet.json and atlas grid
>
> If you draw or assemble a spritesheet yourself, place `pet.json` and a static transparent RGBA PNG (keep it at or below 8 MB, with no borders or gutters and unused cells left fully transparent) in the same folder:
>
> ```json theme={null}
> {
>   "id": "my-mint-pet",
>   "displayName": "My Mint Pet",
>   "description": "A mint-colored companion.",
>   "spritesheetPath": "spritesheet.png",
>   "spriteVersionNumber": 2
> }
> ```
>
> * `id`: Lowercase letters, digits, `.`, `_`, or `-` (1–80 chars); must not collide with the four bundled IDs (`minimax-original`, `minimax-tako`, `octopus-girl-v2`, `mmx-octopus`).
> * `displayName`: 1–80 chars; `description`: optional, up to 300 chars; `spritesheetPath`: `.png` or `.webp` filename in the same folder; `spriteVersionNumber`: number `2` (preferred) or `1`.
>
> | Version | Image dimensions | Grid (192 × 208 px per cell) | Content |
> | - | - | - | - |
> | **v2 (preferred)** | **1536 × 2288 px** | 8 columns × 11 rows | Rows 0–8 animations (57 cells) + Rows 9–10 look poses (16 cells) |
> | **v1** | **1536 × 1872 px** | 8 columns × 9 rows | Rows 0–8 animations only (57 cells), no mouse-follow |
>
> * **Rows 0–8 (animations)**: `0: idle` (6), `1: running-right` (8), `2: running-left` (8), `3: waving` (4), `4: jumping` (5), `5: failed` (8), `6: waiting` (6), `7: running` (6, working pose), `8: review` (6, result ready).
> * **Rows 9–10 (v2 look directions)**: 16 static gaze poses. Row 9 Column 0 is `0°` (straight up), advancing clockwise in `22.5°` steps (`0°–157.5°` on Row 9, `180°–337.5°` on Row 10).
>
> To validate locally (Node.js 22+): `node "<skill-dir>/scripts/validate-art.mjs" "<output-dir>/pet.json"`.

## Permissions and notes

* **Permissions**: Requests only `session.read` to read visible conversation status and latest replies; does not use the microphone, camera, or system notifications. Users can turn this off anytime in the plugin's [permission panel](https://agent.minimax.io/docs/miniapp/host/security.md).
* **Reminder coverage**: Summarizes recent visible conversations and surfaces new answer-needed prompts that arrive while the pet is connected; prompts sent before opening the pet, or extra tasks when many are running at once, may not trigger individual alerts.
* **Read-only companion**: Never starts Agent turns, writes to chat inputs, stops tasks, or answers questionnaires. The main window switches only when you click **Open conversation / Go answer**, and preferences plus imported pets stay in the plugin's isolated data directory.
