Skip to main content
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.

Overview

Appearance and switching

Comes with four built-in pets, animation previews, and import/removal for custom spritesheets.

Task reminders and open conversation

View recent notices, visible tasks, and Markdown-rendered replies; jump straight to conversations that need your answer.

Transparent desktop window

Click Show on desktop for an always-on-top transparent window with click-through margins, cursor gaze tracking, and auto-hiding cards.

Create pets from a prompt

Mention @minimax-pet to have the Agent generate and validate a compliant spritesheet ready to import.

Install and open

Search for MiniMax Pet in the MiniMax Code plugin marketplace, install it, 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:

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.
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:
  • 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.
  • 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.
  • 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.