Configuration

Complete configuration reference for Thand Agent.

Overview

Thand Agent uses YAML configuration files to define behavior, providers, roles, and workflows. Configuration can be provided via:

Configuration is loaded in this order (later sources override earlier ones):

  1. Default values
  2. Configuration file (~/.thand/config.yaml)
  3. Environment variables (prefixed with THAND_)
  4. Command line flags

Important: If you are using Temporal (recommended for production), you must configure specific Search Attributes in your Temporal Namespace. See Temporal Configuration for critical setup instructions.

Basic Configuration Structure 

# Server connection (required)
login:
  endpoint: "https://thand.example.com"

secret: changeme

# Temporal (recommended)
services:
  temporal:
    host: "us-central1.gcp.api.temporal.io"
    port: 7233
    namespace: thand
    api_key: "changeme"

Environment Variables

All configuration options can be set via environment variables using the THAND_ prefix:

export THAND_LOGIN_ENDPOINT="https://thand.example.com"
export THAND_SECRET="changeme"

# Temporal (recommended)

export THAND_SERVICES_TEMPORAL_HOST="us-central1.gcp.api.temporal.io"
export THAND_SERVICES_TEMPORAL_PORT=7233
export THAND_SERVICES_TEMPORAL_NAMESPACE="thand"
export THAND_SERVICES_TEMPORAL_MTLS_PEM=""
export THAND_SERVICES_TEMPORAL_API_KEY=""

Nested configuration uses underscores:

export THAND_PROVIDERS_AWS_REGION="us-west-2"

Sections

Table of contents