# Mapbox CLI

This section is the command reference for the **Mapbox CLI** (`mapbox`): every command group, the commands inside it, and their flags. For an introduction to the CLI, installing it, and how it behaves, see the [Mapbox CLI guide](https://docs.mapbox.com/cli/guides/).

## Shared parameters

The command groups that call a Mapbox API — Accounts, Fonts, Geocoder, Search, Sprites, Static, Styles, and Tilesets — all take:

| Parameter | Description |
| --- | --- |
| `--username`/`-u` | Fills the `{username}` path placeholder. Falls back to `MAPBOX_USERNAME`, then to the signed-in user — so you can omit it once you're signed in. |
| `--token`/`-t` | Access token. Falls back to `MAPBOX_ACCESS_TOKEN`, then stored credentials. |
| `--profile <name>` | Which stored credentials to use. |
| `--id <value>` | On a command that returns a list, print only the row with that `id` or `name`. |

Each command group's own reference page lists only what's specific to it. Alphabetically, the command groups are:

### [Accounts](https://docs.mapbox.com/cli/reference/accounts/)

Access tokens and the scopes an account can grant them.

### [Agent Skills](https://docs.mapbox.com/cli/reference/agent-skills/)

Installs the [Mapbox Agent Skills](https://github.com/mapbox/mapbox-agent-skills) — hand-written guidance for coding agents on building with Mapbox. A different thing from Generate Skills below.

### [Authentication](https://docs.mapbox.com/cli/reference/authentication/)

Signs the CLI in to your Mapbox account and manages the token every other command uses: `login`, `logout`, `refresh`, and `whoami`.

### [Completion](https://docs.mapbox.com/cli/reference/completion/)

Prints a shell completion script on stdout, for bash, zsh, fish, or PowerShell.

### [Fonts](https://docs.mapbox.com/cli/reference/fonts/)

The font faces map styles render text with.

### [Generate Skills](https://docs.mapbox.com/cli/reference/generate-skills/)

Writes the CLI's built-in command surface out as an [Agent Skill](https://code.claude.com/docs/en/skills), for a coding agent to read. A different thing from Agent Skills above.

### [Geocoder](https://docs.mapbox.com/cli/reference/geocoder/)

Converts between place names and coordinates, forward and reverse.

### [Search](https://docs.mapbox.com/cli/reference/search/)

Text search, reverse lookup, category search, and the category list, from the Search Box API.

### [Sprites](https://docs.mapbox.com/cli/reference/sprites/)

The sprite sheet a style draws its icons from, and the individual icons in it.

### [Static](https://docs.mapbox.com/cli/reference/static/)

A rendered map image or raster tile from a style.

### [Styles](https://docs.mapbox.com/cli/reference/styles/)

Map styles and their drafts.

### [Tilesets](https://docs.mapbox.com/cli/reference/tilesets/)

Tiles by tileset ID — raster, vector, and MRT — plus Tilequery, what vector features exist at or near a given point.

### [Tilesets-cli alias](https://docs.mapbox.com/cli/reference/tilesets-cli/)

Forwards everything verbatim to the separately installed [Tilesets CLI](https://github.com/mapbox/tilesets-cli) — a different program from the Tilesets commands above.

### [Uninstall](https://docs.mapbox.com/cli/reference/uninstall/)

Removes the `mapbox` binary. Stored credentials and a separately installed `tilesets` binary survive.

### [Usage](https://docs.mapbox.com/cli/reference/usage/)

Reports account or token usage by product, by day.

## Global options

[Global options](https://docs.mapbox.com/cli/reference/global-options/) — `--output`/`-o`, `--schema`, `--dry-run`, `--yes`/`-y`, `--timeout`, `--use-login`, and `--debug` — apply across every command, not only the API ones above.