traceloom auth

Store your TraceLoom API key locally so all subsequent commands are authenticated automatically.

Usage

traceloom auth [options]

Interactive Mode

Run traceloom auth without any flags to be prompted for your API key:

traceloom auth
# Enter your TraceLoom API key (starts with tlk_): tlk_...

The key is saved to ~/.traceloom/credentials with restricted file permissions (0600) so only your user can read it.

Non-Interactive Mode (CI)

Pass the key directly using the --key flag to skip the interactive prompt:

traceloom auth --key tlk_your_api_key_here

Environment Variable

Set the TRACELOOM_API_KEY environment variable to authenticate without running traceloom auth at all. This takes precedence over the credentials file and is the recommended approach for CI pipelines:

export TRACELOOM_API_KEY=tlk_your_api_key_here

Options

Next Steps

• traceloom init — create a .traceloom.yml config file in your project
• CI/CD Integration — use TRACELOOM_API_KEY as a secret in GitHub Actions
• CLI Overview — see all available commands

Last updated: April 2026