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

# Configuration

> Launcher flags, environment variables, and on-disk locations for Fleet Prime Agent.

## Launcher flags

```bash theme={null}
fleet-agent [--host <host>] [--port <port>]
```

| Flag     | Default     | Purpose                                                                                                |
| -------- | ----------- | ------------------------------------------------------------------------------------------------------ |
| `--host` | `127.0.0.1` | Bind address for the web server. Non-loopback requests are rejected with `403 Loopback requests only`. |
| `--port` | `3000`      | TCP port for the web server.                                                                           |

`fleet-agent agent <args>` bypasses the web server entirely and runs the pinned engine CLI.

## Environment variables

| Variable                         | Purpose                                                                                                  |
| -------------------------------- | -------------------------------------------------------------------------------------------------------- |
| `PRIME_AGENT_WORKSPACE_ROOT`     | Default workspace root for the server. The launcher sets it to the directory you ran `fleet-agent` from. |
| `PRIME_BRIDGE_DEBUG`             | Enable verbose bridge logging in `web/server`.                                                           |
| `VITE_FLEET_PI_CHAT_RUNTIME_URL` | Point the browser at a remote runtime instead of the local server.                                       |
| `PRIME_AGENT_REPOSITORY_URL`     | Installer override: repository URL to clone.                                                             |
| `PRIME_AGENT_REPOSITORY_REF`     | Installer override: branch or tag to clone.                                                              |
| `PRIME_AGENT_PNPM_VERSION`       | Installer override: ephemeral pnpm version.                                                              |
| `PRIME_AGENT_SHIM_DIR`           | Installer override: directory for the `fleet-agent` shim.                                                |

## On-disk locations

| Path                       | Purpose                                                                                                                                           |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `~/.prime/agent/`          | Engine state shared with `prime-agent`: provider credentials and settings, session transcripts, logs, and the managed IPython kernel environment. |
| `~/.local/bin/fleet-agent` | The launcher shim written by the installer (override with `PRIME_AGENT_SHIM_DIR`).                                                                |
| `PRIME_AGENT_RUNTIME.json` | The pinned engine package, version, tarball URL, and SHA-256.                                                                                     |

## Dependency policy

Dependency updates in the repository respect a 7-day minimum release age: `.npmrc` sets `min-release-age=7` and Dependabot uses a matching cooldown. Enforcement requires npm 11.10 or later. For an urgent security patch younger than 7 days, override explicitly with `npm install --min-release-age=0 <pkg>`.