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

# Pets

Pets are optional animated companions for following work. Where a pet appears
and what it shows depend on the interface you use. Choosing a pet changes its
appearance, not how ZeroTwo completes tasks.

<Tabs>
  <Tab title="ZeroTwo desktop app">
    ## Use a floating pet

    In the ZeroTwo desktop app, a pet can float above other app windows and help
    you follow activity across your chats.

    ### Choose and wake a pet

    1. Open the profile menu at the bottom of the app and select **Pets**. You can
       also open [**Settings**](zerocode://settings) and go to **Pets**.
    2. Choose a built-in or custom pet.
    3. Enter `/pet`, or open the command menu and select **Wake Pet**.

    Select **Tuck Away Pet** in **Settings > Pets** or the command menu, or enter
    `/pet` again, to hide the pet. Your selection and the pet's position persist
    when you reopen the app.

    When you select a custom pet, it also appears in your **Profile** view.

    ### Understand pet status

    | Status          | Meaning                                                  |
    | --------------- | -------------------------------------------------------- |
    | **Running**     | A chat is actively working.                              |
    | **Needs input** | A chat needs your approval, answer, or another decision. |
    | **Ready**       | A chat has completed and has unread activity.            |
    | **Blocked**     | A chat failed or encountered a system error.             |

    When more than one chat has activity, the pet prioritizes chats that need
    input, followed by blocked, ready, and running chats. Open the activity tray to
    choose a chat.

    Select the pet to return to ZeroTwo, or select an activity to open its chat.
    The activity tray is separate from [system
    notifications](/notifications).

    ### Follow Computer Use

    On macOS, the [Computer Use](/computer-use) picture-in-picture window can
    attach to an awake pet. Move the pet, and the window follows.

    ### Create a custom pet

    1. Open **Settings > Pets** and select **Create your own pet**.
    2. The app installs the bundled `hatch-pet` skill, reloads skills, and opens a
       new chat.
    3. Describe the pet you want and send the prompt.
    4. When the task finishes, return to **Settings > Pets**, select **Refresh**,
       and choose your new pet.

    Custom pets created in the desktop app are stored locally on your computer.
    They don't automatically sync to ZeroTwo web.

    ### Reduce animation

    Pets respect your operating system's reduced motion setting. When reduced
    motion is enabled, the pet uses a still frame instead of sprite animation.
  </Tab>

  <Tab title="ZeroTwo on the web">
    ## Choose a pet on the web

    If Pets are available for your account and workspace, open **Settings >
    Personalization > Pet > Select pet**. Choose a built-in pet, or choose
    **Default** to use ZeroTwo without a pet.

    A web pet appears inside supported ZeroTwo Work chats. It doesn't provide the
    desktop app's floating overlay, activity tray, or `/pet` command.

    ### Upload a custom pet

    Select **Upload pet** to add a custom sprite sheet. The file must be a
    transparent PNG or WebP, exactly 1536 × 1872 pixels, and no larger than 20 MiB.
    You can edit, download, refresh, or delete uploaded pets from the same setting.
  </Tab>

  <Tab title="ZeroTwo desktop app">
    ## Choose a terminal pet

    In an interactive ZeroTwo desktop app session:

    * Enter `/pets` or `/pet` to open the pet picker.
    * Enter `/pets <name>` to choose a pet directly.
    * Enter `/pets off` to disable terminal pets.

    The picker includes built-in pets and compatible custom pets installed on your
    computer. A terminal pet reports activity for the current CLI session. It uses
    **Running**, **Needs input**, **Ready**, and **Blocked** states, but it doesn't
    provide the desktop app's multiple-chat activity tray.

    Terminal pets require iTerm2 3.6 or later, or a terminal with Kitty graphics or
    Sixel support. They are unavailable inside tmux and Zellij.
  </Tab>

  <Tab title="ZeroTwo desktop app">
    ## Pets in the desktop app

    The ZeroTwo desktop app doesn't provide a pet picker or floating pet overlay.
    Use the ZeroTwo desktop app when you want to use your own pet.
  </Tab>
</Tabs>

## Related docs

* [Notifications](/notifications)
* [Long-running work](/long-running-work)
* [ZeroTwo desktop app settings](/reference/settings#pets)