# Commands

## `pokebuddy hatch`

Hatches a companion and stores it locally.

```bash
pokebuddy hatch
pokebuddy hatch --force
pokebuddy hatch --all
```

## `pokebuddy list`

Lists discovered companions.

```bash
pokebuddy list
```

## `pokebuddy dex`

Shows every known launch companion.

```bash
pokebuddy dex
```

## `pokebuddy show [name]`

Shows a detailed companion card.

```bash
pokebuddy show zapbit
```

## `pokebuddy poke [name]`

Interacts with a companion and increases XP.

```bash
pokebuddy poke zapbit
```

## `pokebuddy feed [name] [thing]`

Feeds context, cache, file paths or playful offerings.

```bash
pokebuddy feed cachegoblin ./build/cache
```

## `pokebuddy status`

Shows local companion state.

```bash
pokebuddy status
```

## `pokebuddy rename <name> <alias>`

Gives a discovered companion a local alias.

```bash
pokebuddy rename zapbit Sparkinho
```