Skip to main content

​
Prerequisites

  • Node.js 22.8.0 or later
  • npm 11.10 or later
  • Git
  • Python 3.10 or later for the managed IPython kernel

​
1. Install

Clone the repository and run the installer. It installs the pinned upstream Prime Agent runtime, the web dependencies, builds the production web bundle, and links the fleet-agent command.
The installer places a fleet-agent shim in ~/.local/bin. If that directory is not on your PATH, the installer prints the path to add. See Install for details and overrides.

​
2. Start your workspace

Run Fleet Prime Agent from the project directory you want the agent to work in:
The launcher prints a local URL:
Open it in your browser. The server binds to 127.0.0.1 and rejects non-loopback requests.

​
3. Add a provider and pick a model

On first use, add a model provider in Settings → Providers, or type /login in the composer. Then choose a model in the composer’s model picker. Credentials are stored by the engine under ~/.prime/agent/ and are shared with any existing prime-agent install. See Providers and models for OAuth providers and OpenAI-compatible endpoints.

​
4. Run a turn

Type a request in the composer. The agent streams its work as cards: IPython cells, shell commands, file edits, plans, subagents, and interactive questions you can answer inline. Your session persists after you close the browser; reopen the workspace and resume it from the session list.

​
Prefer a terminal?

The pinned engine’s TUI is available as prime-agent, and fleet-agent agent <args> runs the pinned engine CLI directly. See Terminal interface.

​
Next steps

Web workspace

Projects, tool cards, slash commands, attachments, and settings.

Sessions and projects

How sessions persist, resume, and map to projects.
Last modified on August 30, 2026