# pandora update — Self-Update
Downloads the latest pandora binary from the GitLab releases and replaces the current executable in place.
## Usage
```
pandora update [OPTIONS]
```
## Options
| `-f`, `--force` | Re-install even when already up to date |
| `--guide` | Show this guide |
## Behavior
1. Reads the latest release tag from GitLab.
2. Compares it with the running binary version.
3. If different (or `--force` is set), downloads the `pandora` release asset and replaces the current executable atomically.
## Requirements
- `curl` available on `PATH`.
- Write permission on the directory where `pandora` is installed. Use `sudo` if the binary lives in a system directory like `/usr/local/bin`.
## Examples
```bash
# Update if a newer release is available
pandora update
# Re-install the latest even if already on it
pandora update --force
# Update a system-wide install
sudo pandora update
```
## Exit codes
| 0 | Update succeeded or already up to date |
| 1 | Could not fetch / download / replace the binary |