Command reference

Synopsis

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

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

agentsfleet --help

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.

Getting started

Fleets

Workspaces

Cost control

CLI reference

Updates

Command reference

Command reference

Synopsis

Example with output

Options

Global options

Account and diagnosis

Workspaces and access

Fleets

Secrets and memory

Tenant settings

Errors

​Command reference

​Synopsis

​Example with output

​Options

​Global options

​Account and diagnosis

​Workspaces and access

​Fleets

​Secrets and memory

​Tenant settings

​Errors

​Related pages

Command reference

Synopsis

Example with output

Options

Global options

Account and diagnosis

Workspaces and access

Fleets

Secrets and memory

Tenant settings

Errors

Related pages