#Configure Agent TARS

Agent TARS supports two primary configuration methods:

• CLI flags：for quick experimentation
• Configuration files：recommended for long-term usage

These configuration methods allow you to customize Agent TARS behavior to meet different requirements.

#CLI Flags

agent-tars --help      # view all sub commands and flags
agent-tars [...flags]  # launch Agent TARS with some flags.

For more details please move CLI。

#Config File

#Supported File Formats

Agent TARS automatically looks for the following configuration files in the current directory (in order of priority):

• agent-tars.config.ts (TypeScript, recommended)
• agent-tars.config.yaml (YAML)
• agent-tars.config.json (JSON)

You can also specify one or more configuration file paths using the --config parameter:

agent-tars --config ./my-config.json

#TypeScript (Recommended)

TypeScript configuration provides complete type checking and code completion support, making it the most recommended configuration method:

import { defineConfig } from '@agent-tars/interface';

export default defineConfig({
  // Model configuration
  model: {
    provider: 'anthropic',
    id: 'claude-3-7-sonnet-latest',
    apiKey: process.env.ANTHROPIC_API_KEY,
  },
  
  // Browser control mode
  browser: {
    control: 'hybrid', // 'hybrid', 'visual-grounding', 'dom'
  },

  // ... other configurations
});

#JSON

{
  "model": {
    "provider": "anthropic",
    "id": "claude-3-7-sonnet-latest",
    "apiKey": "your-api-key-here"
  },

  "browser": {
    "control": "hybrid"
  }
}

#YAML

model:
  provider: anthropic
  id: claude-3-7-sonnet-latest
  apiKey: your-api-key-here
  
browser:
  control: hybrid

#Multiple Configuration files

Agent TARS supports merging multiple configuration files, with later configurations overriding earlier ones:

agent-tars --config ./base-config.json --config ./override.yaml

This is useful for managing configurations across different environments, such as base configurations and environment-specific overrides.

#Remote Configuration

Agent TARS supports loading configuration from a remote URL:

agent-tars --config https://example.com/agent-tars-config.json

This is useful for team sharing of configurations or dynamic configurations.