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

# XBOX CLI

> Build, release, and operate games on XBOX from the command line, with the XBOX CLI. A technical preview.

## Start here

> [!NOTE]
>
> The XBOX CLI is a technical preview. Until version 1.0, commands and output can
> change between releases; see [Experimental commands](https://docs.xbox.com/tools/xbox-cli/cli-command-lifecycle.md).
> [Known issues](https://docs.xbox.com/tools/xbox-cli/known-issues.md) lists what's unfinished in the latest release.

| Page | What it covers |
| - | - |
| [Installation](https://docs.xbox.com/tools/xbox-cli/installation.md) | Install and update the CLI on Windows, Linux, or macOS. |
| [Getting started](https://docs.xbox.com/tools/xbox-cli/getting-started.md) | Sign in, choose a seller, and list its games. |
| [Your first playtest](https://docs.xbox.com/tools/xbox-cli/first-playtest.md) | Upload a build, then create, publish, and share a playtest of it. |
| [Use XBOX services in a playtest](https://docs.xbox.com/tools/xbox-cli/xbox-services-in-a-playtest.md) | Prepare a game's achievements, embargo, and XBOX services configuration for a playtest. |
| [Authentication](https://docs.xbox.com/tools/xbox-cli/authentication.md) | Sign in as yourself or as a service principal, check who's signed in, and get PlayFab access. |
| [Known issues](https://docs.xbox.com/tools/xbox-cli/known-issues.md) | Problems and unfinished features in the latest release, and their workarounds. |

## Reference

| Page | What it covers |
| - | - |
| [Commands](https://docs.xbox.com/tools/xbox-cli/commands.md) | Global options, output formats, exit codes, and every command below. |
| [PlayFab API integration](https://docs.xbox.com/tools/xbox-cli/playfab-api.md) | Find and call PlayFab APIs from the terminal. |

The command pages follow the command tree:

* [`xbox`](https://docs.xbox.com/tools/xbox-cli/commands): global options and output formats
  * [`auth`](https://docs.xbox.com/tools/xbox-cli/commands/auth): sign in and out
  * [`context`](https://docs.xbox.com/tools/xbox-cli/commands/context): default values, such as the seller and PlayFab title
  * [`game`](https://docs.xbox.com/tools/xbox-cli/commands/game): Partner Center games
  * [`seller`](https://docs.xbox.com/tools/xbox-cli/commands/seller): Partner Center sellers
  * [`sandbox`](https://docs.xbox.com/tools/xbox-cli/commands/sandbox): XBOX sandboxes
  * [`audience`](https://docs.xbox.com/tools/xbox-cli/commands/audience): a seller's audiences (Experimental)
  * [`package`](https://docs.xbox.com/tools/xbox-cli/commands/package): game packages (Experimental)
  * [`pc`](https://docs.xbox.com/tools/xbox-cli/commands/pc): this PC's XBOX sandbox (Experimental)
  * [`test-account`](https://docs.xbox.com/tools/xbox-cli/commands/test-account): XBOX test accounts and their batches
  * [`playtest`](https://docs.xbox.com/tools/xbox-cli/commands/playtest): XBOX game playtests
  * [`playfab`](https://docs.xbox.com/tools/xbox-cli/commands/playfab): PlayFab services
    * [`api`](https://docs.xbox.com/tools/xbox-cli/commands/playfab/api): call any API endpoint directly
    * [`mps`](https://docs.xbox.com/tools/xbox-cli/commands/playfab/mps): Multiplayer Servers (Experimental)
    * [`file`](https://docs.xbox.com/tools/xbox-cli/commands/playfab/file): entity files
    * [`title-data`](https://docs.xbox.com/tools/xbox-cli/commands/playfab/title-data): title data
    * [`api-policy`](https://docs.xbox.com/tools/xbox-cli/commands/playfab/api-policy): API access policy
    * [`cloudscript`](https://docs.xbox.com/tools/xbox-cli/commands/playfab/cloudscript): CloudScript and Azure Functions (Experimental)
    * [`group`](https://docs.xbox.com/tools/xbox-cli/commands/playfab/group): groups and membership (Experimental)
    * [`player-data`](https://docs.xbox.com/tools/xbox-cli/commands/playfab/player-data): player data
    * [`economy`](https://docs.xbox.com/tools/xbox-cli/commands/playfab/economy): Economy v2 inventory
    * [`experiment`](https://docs.xbox.com/tools/xbox-cli/commands/playfab/experiment): experiments (Experimental)
    * [`player`](https://docs.xbox.com/tools/xbox-cli/commands/playfab/player): player accounts (Experimental)
    * [`privacy`](https://docs.xbox.com/tools/xbox-cli/commands/playfab/privacy): privacy exports (Experimental)
    * [`service-principal`](https://docs.xbox.com/tools/xbox-cli/commands/playfab/service-principal): service-principal access to a studio (Experimental)
  * [`xbl`](https://docs.xbox.com/tools/xbox-cli/commands/xbl): XBOX services configuration (Experimental)
    * [`achievement-image`](https://docs.xbox.com/tools/xbox-cli/commands/xbl/achievement-image): achievement images
  * [`info`](https://docs.xbox.com/tools/xbox-cli/commands/info): version and links
  * [`upgrade`](https://docs.xbox.com/tools/xbox-cli/commands/upgrade): check for a newer release
  * [`feedback`](https://docs.xbox.com/tools/xbox-cli/commands/feedback): open a bug-report draft with environment information
  * [`help`](https://docs.xbox.com/tools/xbox-cli/commands/help): help for any command

## Behavior

| Page | What it covers |
| - | - |
| [Safety and destructive operations](https://docs.xbox.com/tools/xbox-cli/safety.md) | Which commands ask before they change something, and what to do when a change's outcome is unknown. |
| [Configuration](https://docs.xbox.com/tools/xbox-cli/configuration.md) | Settings, the environment variables that set them, and where saved values are kept. |
| [Telemetry](https://docs.xbox.com/tools/xbox-cli/telemetry.md) | What's collected, and how to turn it off. |
| [Audit logging](https://docs.xbox.com/tools/xbox-cli/audit-log.md) | Keep a local record of the PlayFab operations the CLI runs. |
| [Using the XBOX CLI from agents](https://docs.xbox.com/tools/xbox-cli/cli-for-agents.md) | What an AI agent must ask before a change, and how it chooses targets, reads output, and finds APIs. |
| [Experimental commands](https://docs.xbox.com/tools/xbox-cli/cli-command-lifecycle.md) | What compatibility each release promises, and what Experimental means. |


## Related topics

- [Using the XBOX CLI from agents](https://docs.xbox.com/tools/xbox-cli/cli-for-agents.md)
- [Telemetry](https://docs.xbox.com/tools/xbox-cli/telemetry.md)
- [Audit logging](https://docs.xbox.com/tools/xbox-cli/audit-log.md)
- [Login With XBOX](https://docs.xbox.com/services/playfab/api-references/rest/client/authentication/login-with-xbox.md)
- [XBOX Game Development](https://docs.xbox.com/index.md)
