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

# Install a fleet

> Install a fleet from your workspace library.

# 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.

   ```bash theme={"theme":"vesper"}
   agentsfleet library
   ```

   ```text theme={"theme":"vesper"}
   LIBRARY                        NAME                            SECRETS
   github-pr-reviewer             GitHub Pull Request reviewer    github
   <varies>
   ```

2. Install one library entry.

   ```bash theme={"theme":"vesper"}
   agentsfleet install --library github-pr-reviewer
   ```

   ```text theme={"theme":"vesper"}
   ✓ github-pr-reviewer is live.
     Fleet ID: <varies>
     Webhook URLs (register on the upstream provider):
       github: <varies>
   ```

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

```bash theme={"theme":"vesper"}
agentsfleet status
```

```text theme={"theme":"vesper"}
Fleets
Name: github-pr-reviewer
Status: active
Events: <varies>
Budget: <varies>
```

## 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.

```bash theme={"theme":"vesper"}
agentsfleet kill <FLEET_ID>
```

```text theme={"theme":"vesper"}
✓ <varies> killed.
```

```bash theme={"theme":"vesper"}
agentsfleet delete <FLEET_ID>
```

```text theme={"theme":"vesper"}
✓ <varies> deleted.
```

## Related pages

* [Fleet library](/fleets/library)
* [Secrets](/fleets/secrets)
* [Run and control a fleet](/fleets/running)