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

# Command reference

> Commands available in the agentsfleet command-line client.

# Command reference

## Synopsis

The command-line interface (CLI) manages workspaces, fleets, access, secrets, and memory.

```text theme={"theme":"vesper"}
agentsfleet [GLOBAL_OPTIONS] <COMMAND>
```

`<COMMAND>` comes from the tables below. Run any command with `--help` to see its accepted values.

Identifier placeholders come from the matching create or list command. You choose name, path, provider, message, and query values.

## Example with output

```bash theme={"theme":"vesper"}
agentsfleet --help
```

```text theme={"theme":"vesper"}
Usage: agentsfleet [options] [command]

Options:
  -v, --version    Show version
  --api <url>      API base URL
  --json           Machine-readable JSON output
  <varies>

Commands:
  login [options]  Authenticate via browser
  workspace        Manage workspaces
  fleet            Fleet management subcommands
  <varies>
```

## Options

### Global options

`<API_URL>` is the API base URL for your deployment.

| Option            | Effect                                             | Default                       | Unit or range                              |
| ----------------- | -------------------------------------------------- | ----------------------------- | ------------------------------------------ |
| `-v`, `--version` | Prints the client version and exits.               | `false`                       | Boolean                                    |
| `--api <API_URL>` | Sends requests to this API URL.                    | `https://api.agentsfleet.net` | URL beginning with `http://` or `https://` |
| `--json`          | Prints JSON when the command supports it.          | `false`                       | Boolean                                    |
| `--no-input`      | Returns an error instead of asking a question.     | `false`                       | Boolean                                    |
| `--no-open`       | Prints the login URL instead of opening a browser. | `false`                       | Boolean                                    |
| `-h`, `--help`    | Prints help and exits.                             | `false`                       | Boolean                                    |

### Account and diagnosis

| Command                   | Effect                                                     |
| ------------------------- | ---------------------------------------------------------- |
| `agentsfleet login`       | Signs in through a browser or supplied token.              |
| `agentsfleet logout`      | Revokes every active session and clears local credentials. |
| `agentsfleet auth status` | Shows the token source, claims, and server status.         |
| `agentsfleet doctor`      | Checks client settings, authentication, and API access.    |

### Workspaces and access

| Command                                                  | Effect                                                              |
| -------------------------------------------------------- | ------------------------------------------------------------------- |
| `agentsfleet workspace create [NAME]`                    | Creates a workspace and selects it.                                 |
| `agentsfleet workspace list`                             | Lists workspaces.                                                   |
| `agentsfleet workspace use <WORKSPACE_ID>`               | Selects the active workspace on this computer.                      |
| `agentsfleet workspace show [WORKSPACE_ID]`              | Shows one workspace.                                                |
| `agentsfleet workspace secrets`                          | Prints the secret command and dashboard path.                       |
| `agentsfleet workspace delete <WORKSPACE_ID>`            | Removes one workspace from local client state. Remote data remains. |
| `agentsfleet fleet-key create`                           | Creates a key bound to one fleet. The raw key appears once.         |
| `agentsfleet fleet-key list`                             | Lists fleet keys without raw values.                                |
| `agentsfleet fleet-key delete <FLEET_KEY_ID>`            | Revokes a fleet key. Calls using that key fail.                     |
| `agentsfleet api-key create`                             | Creates a tenant API key. The raw key appears once.                 |
| `agentsfleet api-key list`                               | Lists tenant API keys.                                              |
| `agentsfleet api-key revoke <API_KEY_ID>`                | Revokes a tenant API key. Calls using that key fail.                |
| `agentsfleet api-key delete <API_KEY_ID>`                | Deletes metadata for a revoked tenant API key.                      |
| `agentsfleet connector list`                             | Lists connector setup and connection state.                         |
| `agentsfleet connector status <PROVIDER>`                | Shows one connector.                                                |
| `agentsfleet grant list --fleet <FLEET_ID>`              | Lists integration grants for one fleet.                             |
| `agentsfleet grant delete --fleet <FLEET_ID> <GRANT_ID>` | Revokes one grant. Later access through that grant fails.           |

### Fleets

| Command                                             | Effect                                                             |
| --------------------------------------------------- | ------------------------------------------------------------------ |
| `agentsfleet library`                               | Lists installable library entries.                                 |
| `agentsfleet install --library <LIBRARY_ID>`        | Installs one library entry.                                        |
| `agentsfleet fleet update <FLEET_ID> --from <PATH>` | Updates a fleet from a local bundle.                               |
| `agentsfleet list`                                  | Lists fleets in the active workspace.                              |
| `agentsfleet status`                                | Shows every fleet in the active workspace.                         |
| `agentsfleet stop <FLEET_ID>`                       | Stops new work. You can resume the fleet.                          |
| `agentsfleet resume <FLEET_ID>`                     | Resumes a stopped or paused fleet.                                 |
| `agentsfleet kill <FLEET_ID>`                       | Marks a fleet as killed. This cannot be undone.                    |
| `agentsfleet delete <FLEET_ID>`                     | Deletes a killed fleet and its stored data. This cannot be undone. |
| `agentsfleet logs [FLEET_ID]`                       | Shows recent activity.                                             |
| `agentsfleet events <FLEET_ID>`                     | Lists historical events with filters.                              |
| `agentsfleet steer <FLEET_ID> [MESSAGE]`            | Sends a message and streams the response.                          |

`agentsfleet delete` has no dry-run option. Run `agentsfleet kill` first, then check the fleet identifier before deletion.

### Secrets and memory

| Command                                                | Effect                                                                                                                                       |
| ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `agentsfleet secret create <NAME>`                     | Stores a JSON object in the workspace vault under a name that is free. A name already in use is reported as skipped, and nothing is written. |
| `agentsfleet secret update <NAME>`                     | Replaces a stored secret without releasing its name. It accepts the same data options as `agentsfleet secret create`.                        |
| `agentsfleet secret show <NAME>`                       | Confirms that a secret exists without showing its value.                                                                                     |
| `agentsfleet secret list`                              | Lists secret names and metadata.                                                                                                             |
| `agentsfleet secret delete <NAME>`                     | Deletes a secret. Fleets using the secret fail on their next use.                                                                            |
| `agentsfleet memory list --fleet <FLEET_ID>`           | Lists memory entries newest first.                                                                                                           |
| `agentsfleet memory search <QUERY> --fleet <FLEET_ID>` | Searches memory keys and content.                                                                                                            |

`agentsfleet secret delete` has no dry-run option. The deleted secret value cannot be recovered.

### Tenant settings

| Command                                              | Effect                                       |
| ---------------------------------------------------- | -------------------------------------------- |
| `agentsfleet tenant provider show`                   | Shows the active model provider.             |
| `agentsfleet tenant provider create --secret <NAME>` | Selects a self-managed provider secret.      |
| `agentsfleet tenant provider delete`                 | Returns the tenant to the platform provider. |
| `agentsfleet billing show`                           | Shows the tenant balance and recent charges. |

## Errors

| Exit code | Meaning                                                |
| --------- | ------------------------------------------------------ |
| `0`       | The command succeeded.                                 |
| `1`       | Authentication, session, or unexpected failure.        |
| `2`       | Network failure, rate limit, or invalid command input. |
| `3`       | The API returned a server failure.                     |
| `4`       | A supplied value failed validation.                    |
| `5`       | Local configuration is missing or invalid.             |
| `130`     | You interrupted the command.                           |

API failures include a stable error code and request identifier when the server supplies them. Use both values when reporting a problem.

## Related pages

* [Install the client](/cli/install)
* [Global options](/cli/flags)
* [Client configuration](/cli/configuration)
* [Quickstart](/quickstart)