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

# otter-jade

> Desktop pet otter with growth stages, care mechanics, and saved state.

`otter-jade` is a desktop pet otter. Jade hatches from an egg, grows through pup and teen to adult, walks screen edges, and reacts to pointer input.

## Usage

```bash theme={null}
otter-jade
```

Optional autostart. Add to compositor autostart if you want Jade at login.

```bash theme={null}
# Reset persisted state on launch
otter-jade --reset

# Non-persistent showcase mode
otter-jade --demo
```

## Interaction

| Input       | Action                       |
| ----------- | ---------------------------- |
| Left click  | Pet Jade                     |
| Right click | Menu: feed, clean, nap, quit |

## Growth and care

* Four stages: egg, pup, teen, adult
* Sprite animations for idle, walk, sleep, happy, hungry, dirty, eating, cleaning, petting, and more
* Hunger, cleanliness, and mood affect behavior, not meters
* Random color and rare shiny rolls when the egg hatches
* State stored at `$XDG_STATE_HOME/otter-shell/otter-jade.state` (fallback: `$HOME/.local/state/otter-shell/`)

## Configuration

Config file: `~/.config/otter-shell/otter-jade.conf`

```conf theme={null}
size = 96
fps = 60
movement_speed = 90
idle_pose_interval_ms = 2700
edge_bias_percent = 55
margin = 24
shiny_odds = 4096
```

Edit via [otter-settings](/desktop/otter-settings) or directly in the config file.