Skip to main content

​
Install a fleet

​
What this does

This creates a fleet from one library entry. Installation is the only creation step; there is no separate start command.

​
Before you begin

Sign in and select a workspace. Save every secret required by the library entry.

​
Steps

  1. Browse the platform library.
  2. Install one library entry.
  3. Register each printed webhook URL with its provider. For GitHub, open Repository settings → Webhooks → Add webhook. Use the matching workspace webhook secret.

​
Verify it works

​
Common problems

UZ-BUNDLE-003 means the workspace lacks a required secret. Create each named secret and run the install command again. UZ-AGT-006 means the fleet name already exists. Pass --name <UNIQUE_NAME> to create another fleet from the same entry. After any failed install, run agentsfleet list before retrying. Retry only when the fleet is absent.

​
Remove or undo

Deleting a fleet removes its events, telemetry, sessions, grants, keys, and memory. This loss cannot be undone. <FLEET_ID> comes from agentsfleet list. Kill the fleet before deleting it.