Skip to main content
Fleet Prime Agent is a local, single-user tool. Its security posture reflects that.

Network exposure

  • The web server binds to 127.0.0.1:3000 by default.
  • The production launcher rejects requests that do not originate from loopback with 403 Loopback requests only, even if you bind another host.
  • There is no multi-user authentication and no token layer. Do not expose the port to untrusted networks; anyone who can reach it can drive the agent with your credentials and filesystem access.

Code execution

The agent executes real code on your machine: IPython cells, shell commands, and file edits run with your user’s permissions in the bound workspace directory. Fleet has no approval prompt in the browser: when the agent asks a question, the workspace answers it automatically with a skip. Run Fleet in projects you trust.

Credentials

Provider API keys and OAuth tokens are stored by the pinned engine under ~/.prime/agent/, shared with any prime-agent install. When you save an API key in Fleet, the server writes it to the engine’s auth.json with owner-only permissions (0600). Fleet rejects a custom provider baseUrl that contains a username, password, or credential-like query parameter, and strips these from stored URLs before sending provider details to the browser.

Runtime integrity

  • On first launch, Fleet downloads the Prime Agent Rust runtime pinned in PRIME_AGENT_RUNTIME.json and verifies both the archive SHA-256 and the extracted executable SHA-256. On a mismatch, Fleet refuses to install it. Fleet re-checks the cached executable’s SHA-256 on every launch and downloads it again if the check fails.
  • npm run check fails if the pin and the installed dependencies drift.
  • On startup, the server probes the daemon socket and refuses to attach to a daemon that is not a Rust daemon with the pinned protocol, rather than silently driving an unexpected engine.

Known gaps

  • SSE replay buffers are in-memory only; sequence numbers do not survive a restart.
Last modified on November 8, 2026