# amfelt download

Download the latest agent binary.

Download the amfelt binary for the current OS and architecture
from the Amfelt API, verify its SHA256 checksum against the server-
supplied X-Checksum header, and write it atomically to disk.

The target path defaults to the directory of the currently-running
binary; override with `--target`. The default version is "latest".

Uses `--api-url`, else the api-endpoint setting in the agent's own
config.yaml or `$AMFELT_API_ENDPOINT`, else the endpoint `register`
remembered beside the identity. It never falls back to the built-in default:
this command fetches an executable and writes it to disk, so it never
guesses which host to fetch it from. `--verify-only` is
the exception — it hashes the binary already present and never asks the
network anything.

Examples:

```text
  # Download the latest agent from the endpoint it registered with
  amfelt download
```

```text
  # Download a specific version into /usr/local/bin, endpoint as a flag
  amfelt download --api-url "$AMFELT_API_ENDPOINT" --version 5.0.0 --target /usr/local/bin/amfelt
```

```text
  # Print the sha256 of the current binary (do not download; no endpoint needed)
  amfelt download --verify-only
```

## Usage

```text
amfelt download [flags]
```

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--api-url` | `string` | — | API base URL — overrides `$AMFELT_API_ENDPOINT`, api-endpoint in the config file and the endpoint remembered at registration |
| `--no-verify` | `bool` | `false` | Skip SHA256 verification of the download (not recommended) |
| `--target` | `string` | — | Destination path (default: same directory as the running binary) |
| `--verify-only` | `bool` | `false` | Print the SHA256 of the current binary and exit — no download |
| `--version` | `string` | `latest` | Release version to download (e.g., 'latest' or '4.3.0') |
{.clidoc-flags-table}

## Global flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--amfelt-dir` | `string` | `.amfelt` | directory for workspace files (such as plugins); does not move agent identity (controlled by AMFELT_DIR) |
| `--config` | `string` | — | directory or filename of the application configuration |
| `-f`, `--format` | `string` | `default` | log format to use; either default, pretty, or json |
| `-l`, `--level` | `string` | `info` | minimum log level to display; either error, warn, info, or debug |
| `-v`, `--verbose` | `bool` | `false` | trigger to use verbose logging |
{.clidoc-flags-table}

---

Generated from `amfelt` v5.6.3.