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

# Run and control a fleet

> Inspect, message, stop, resume, kill, and delete a fleet.

# Run and control a fleet

## What this does

These commands show fleet activity and change lifecycle state. Every command uses the active workspace.

## Before you begin

Install a fleet. Copy its identifier from `agentsfleet list`.

## Steps

1. List fleet identifiers.

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

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

2. View recent activity.

   `<FLEET_ID>` comes from the list output.

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

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

3. Send a manual message.

   ```bash theme={"theme":"vesper"}
   agentsfleet steer <FLEET_ID> "check current health"
   ```

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

4. Stop new work while keeping the fleet resumable.

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

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

5. Resume the fleet.

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

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

## Verify it works

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

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

## Common problems

`UZ-AGT-009` means the fleet does not exist in the active workspace. Check the workspace and fleet identifier.

`UZ-AGT-012` means the fleet cannot accept a message in its current state. Resolve the cause or resume a stopped fleet.

Network failures are not retried by lifecycle commands. Check `agentsfleet doctor`, then run the command again.

## Remove or undo

Stopping is reversible with `resume`. Killing is permanent but keeps the fleet records until deletion.

Deleting removes all fleet records and cannot be undone. The client has no dry-run option for either command.

```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 overview](/fleets/overview)
* [Troubleshooting](/fleets/troubleshooting)
* [Command index](/cli/agentsfleet)