Launcher flags
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 Prime Agent Rust binary with your arguments.
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. |
FLEET_PRIME_AGENT_BIN | Path to a native Prime Agent binary to use instead of the pinned runtime Fleet downloads. Fleet starts the daemon with <bin> --mode daemon --daemon-socket <socket>. |
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. |
TYPESAFE_API_KEY | Optional key for composer command routing (Settings → Chat → Describe a command). A key saved in Settings takes precedence. Set FLEET_TYPESAFE_ENABLED=0 to turn the feature off. |
THESYS_API_KEY | Optional Thesys key that lets OpenUI Cloud build dashboards (Settings → Dashboards). A key saved in Settings takes precedence. Without a key, the assistant writes dashboards itself. |
FLEET_DASHBOARD_MODEL | Provider-qualified model OpenUI Cloud uses to build dashboards, for example openai/gpt-6-luna. A model saved in Settings takes precedence. Defaults to anthropic/claude-sonnet-5.5. |
VITE_OPENUI_CLIENT_KEY | Optional publishable OpenUI browser client key. It starts with pk-th-, and you create it in the Thesys console under client API keys. When set, the web app sends OpenUI render diagnostics to Thesys Reliability Monitoring. Events are sent without response text. Do not reuse THESYS_API_KEY, which stays on the 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. |
~/.prime/agent/thesys.json | The Thesys API key and dashboard builder model saved in Settings → Dashboards. Readable by the owner only. |
~/.prime/fleet/runtimes/<version>/<platform>/ | The pinned Prime Agent Rust runtime that Fleet downloads and verifies on first launch: the prime-agent executable and its prime-agent-runtime directory. |
$TMPDIR/prime-agent-<uid>/daemon.sock | The socket of the daemon Fleet starts or reuses. |
~/.local/bin/fleet-agent | The launcher shim written by the installer (override with PRIME_AGENT_SHIM_DIR). |
PRIME_AGENT_RUNTIME.json | The pinned engine: the Rust runtime version with per-platform archive and executable SHA-256, plus the npm package tarball and SHA-256. |
Dependency policy
Dependency updates in the repository respect a 7-day minimum release age:pnpm-workspace.yaml sets minimumReleaseAge: 10080 (7 days in minutes) and Dependabot uses a matching 7-day cooldown. Dependabot security-advisory updates are exempt from the cooldown.