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

# Installation

> Download and start the LauncherForge interactive CLI.

# Install the LauncherForge CLI

The LauncherForge CLI is a terminal application with an interactive menu. It guides you through authentication, build uploads, status checks, version listing, permissions, and session management.

## Download

Download the CLI from the LauncherForge dashboard or the official distribution location provided to your workspace.

<Warning>
  Only use the official LauncherForge download. Do not run copies received from unknown sources.
</Warning>

## Start the application

<Steps>
  <Step title="Extract the package">
    Extract the downloaded archive when the CLI is distributed as a compressed file.
  </Step>

  <Step title="Open a terminal">
    Open PowerShell, Windows Terminal, or another supported terminal in the CLI folder.
  </Step>

  <Step title="Run the executable">
    Start the LauncherForge CLI executable.
  </Step>

  <Step title="Authenticate">
    When no valid session exists, follow the interactive login prompts.
  </Step>
</Steps>

## Interactive behavior

You do not need to memorize deployment flags. Use the arrow keys and confirmation controls shown in the terminal.

```text theme={null}
LauncherForge CLI

❯ Upload a build
  View upload status
  List versions
  Manage permissions
  Sign out
  Show CLI version
```

## Updating

When a newer CLI version is available:

1. Close the current CLI.
2. Download the official updated build.
3. Replace the previous executable or folder.
4. Start the CLI and check **Show CLI version**.

## Security

* Do not share stored sessions or access tokens.
* Sign out on shared computers.
* Do not upload credentials inside a game build.
* Verify the selected workspace and game before publishing.