Skip to main content

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.

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

​
What it can do

Anything the Galtea API 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. 
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.

​
Your first command

Once you’re authenticated, list your products to validate end-to-end auth and connectivity: 
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.
Run galtea sync after a new Galtea API release to refresh the command tree.
galtea help
For parameter, request body, and response shape details, see the REST API tab.

​
Hand it to your coding agent

The CLI is a great fit for AI coding assistants. Install the Galtea 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.