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

# Usage

> Authenticate the Galtea CLI and explore the command surface

The `galtea` CLI is a terminal-native client for the Galtea AI testing & evaluation platform. Every [REST API](/api-reference) operation ships as a `galtea <noun> <verb>` command, auto-generated from the live OpenAPI spec.

### What it can do

Anything the [Galtea API](/api-reference) does — every endpoint is reachable as a CLI command, with auth, retries, and shell completion handled for you.

### Why use it

* **Let your coding agent manage Galtea for you.** Claude Code, Cursor, Windsurf, and other agents can use the CLI to create products, run evaluations, pull inference results, and more — without leaving your editor.
* **Script your workflows.** Automate repetitive tasks like batch-creating tests, kicking off evaluations from CI/CD, or syncing specifications across environments.
* **Faster than the dashboard for quick lookups.** List the last 10 evaluations, check a session's status, or pull inference results in seconds.

### Authentication

The CLI supports both an interactive flow for local use and a non-interactive flow for CI and Docker.

<Tabs>
  <Tab title="Interactive">
    ```bash theme={"system"}
    galtea login
    # Paste your gsk_* API key when prompted.
    ```

    The key is validated against the server, then stored in your user config directory, typically `~/.config/galtea/apis.json`, with mode `0600` (only your user can read it). You can grab a `gsk_*` key from the [settings page](https://platform.galtea.ai/settings).
  </Tab>

  <Tab title="Non-interactive / CI">
    ```bash theme={"system"}
    export GALTEA_API_KEY=gsk_...
    ```

    <Tip>
      If `GALTEA_API_KEY` is exported in the environment, running `galtea login` becomes **optional** — running it anyway stores the key to disk for future shells.
    </Tip>
  </Tab>
</Tabs>

### Your first command

Once you're authenticated, list your products to validate end-to-end auth and connectivity:

```bash theme={"system"}
galtea products list
```

If this returns a list (even an empty one) instead of a `401 Unauthorized`, you're ready to go.

### Discovering all commands

These are the available OpenAPI commands that were downloaded to your machine.

<Info>
  Run `galtea sync` after a new [Galtea API](/api-reference) release to refresh the command tree.
</Info>

```bash theme={"system"}
galtea help
```

For parameter, request body, and response shape details, see the [**REST API**](/api-reference) tab.

### Hand it to your coding agent

The CLI is a great fit for AI coding assistants. Install the [Galtea Agent Skill](/sdk/integrations/agent-skill) and Claude Code, Cursor, Windsurf, or any other Agent-Skills-compatible client will reach for `galtea` on your behalf — picking the right command, handling authentication, and following the workflows our team has already validated, so you don't have to brief your agent on Galtea first.