Configuration

Complete reference for AGTerm environment variables and configuration options.

Server Configuration

Core Settings

Variable	Default	Description
`AGTERM_PORT`	`3000`	Server port
`AGTERM_HOST`	`0.0.0.0`	Server host/bind address
`NODE_ENV`	`development`	Environment mode (`production` requires `AGTERM_SECRET`)
`AGTERM_SECRET`	`dev-secret-...`	JWT secret key (required in production)

CORS & Security

Variable	Default	Description
`AGTERM_CORS_ORIGIN`	`http://localhost:5173` (dev)	Allowed CORS origin

Feature Flags

Variable	Default	Description
`AGTERM_ALLOW_SHELL`	`true`	Enable/disable shell agent
`AGTERM_VAULT_ENABLED`	`true`	Enable secure API key vault

Session Management

Variable	Default	Description
`AGTERM_MAX_SESSIONS`	`10`	Maximum concurrent sessions (1-1000)
`AGTERM_SESSION_TIMEOUT`	`3600`	Session idle timeout in seconds

Agent Configuration

Variable	Default	Description
`AGTERM_MAX_ITERATIONS`	`50`	Maximum iterations for autonomous loops
`AGTERM_DEFAULT_PROVIDER`	`anthropic`	Default LLM provider
`AGTERM_DEFAULT_MODEL`	—	Default model name

LLM Provider API Keys

Direct Providers

Variable	Provider	Required For
`ANTHROPIC_API_KEY`	Anthropic	Claude Code, AGTerm
`GOOGLE_API_KEY`	Google	Gemini CLI, AGTerm
`OPENAI_API_KEY`	OpenAI	Codex CLI, AGTerm

Gateway Providers

Variable	Provider	Notes
`TOGETHER_API_KEY`	Together AI	Open-source models
`OPENROUTER_API_KEY`	OpenRouter	Multi-provider gateway
`GROQ_API_KEY`	Groq	Ultra-fast inference
`FIREWORKS_API_KEY`	Fireworks AI	Fast open-source models
`MISTRAL_API_KEY`	Mistral AI	European AI provider

Local/Proxy Providers

Variable	Default	Description
`OLLAMA_BASE_URL`	`http://localhost:11434`	Ollama server URL
`LITELLM_BASE_URL`	`http://localhost:4000`	LiteLLM proxy URL
`LITELLM_API_KEY`	—	LiteLLM API key

Agent-Specific Model Overrides

Variable	Agent	Description
`CLAUDE_MODEL`	Claude	Model for Claude Code
`CLAUDE_MAX_TOKENS`	Claude	Max tokens per response
`GEMINI_MODEL`	Gemini	Model for Gemini CLI
`CODEX_MODEL`	Codex	Model for Codex CLI
`OPENAI_MODEL`	Codex	Alternative for Codex

Directories

Variable	Default	Description
`AGTERM_DIR`	`~/.agterm`	AGTerm configuration directory
`AGTERM_WORKSPACE_ROOT`	`~/.agterm/workspaces`	Session workspace directory

Rate Limiting

Variable	Default	Description
`AGTERM_RATE_LIMIT_WINDOW`	`900000` (15 min)	Rate limit window in milliseconds
`AGTERM_RATE_LIMIT_MAX`	`100`	Maximum requests per window

UI Configuration

Variable	Default	Description
`AGTERM_THEME_DEFAULT`	`agterm-dark`	Default terminal theme

JupyterHub Integration

Variable	Description
`JUPYTERHUB_USER`	JupyterHub username (used for auth fallback)
`NB_USER`	Alternative notebook user variable

Example Configuration

Development Setup

# Minimal development config
export ANTHROPIC_API_KEY="sk-ant-..."
export AGTERM_ALLOW_SHELL=true

Production Setup

# Required
export NODE_ENV=production
export AGTERM_SECRET="your-secure-random-secret-here"
export AGTERM_CORS_ORIGIN="https://your-domain.com"

# Providers (at least one)
export ANTHROPIC_API_KEY="sk-ant-..."
export GROQ_API_KEY="gsk_..."

# Security
export AGTERM_ALLOW_SHELL=false
export AGTERM_VAULT_ENABLED=true

# Limits
export AGTERM_MAX_SESSIONS=50
export AGTERM_SESSION_TIMEOUT=7200
export AGTERM_RATE_LIMIT_MAX=200

Multi-Provider Setup

# All major providers
export ANTHROPIC_API_KEY="sk-ant-..."
export GOOGLE_API_KEY="AIza..."
export OPENAI_API_KEY="sk-..."
export GROQ_API_KEY="gsk_..."
export TOGETHER_API_KEY="..."

# Local Ollama
export OLLAMA_BASE_URL="http://localhost:11434"

# Defaults
export AGTERM_DEFAULT_PROVIDER=anthropic
export AGTERM_DEFAULT_MODEL=claude-sonnet-4-20250514

Local-Only Setup

# Ollama only (no external API calls)
export OLLAMA_BASE_URL="http://localhost:11434"
export AGTERM_DEFAULT_PROVIDER=ollama
export AGTERM_DEFAULT_MODEL=llama3.3

# Disable features that need external APIs
export AGTERM_VAULT_ENABLED=false

Configuration Precedence

Settings are resolved in this order (highest priority first):

Session creation parameters — provider and model in API request
CLI commands — /provider and /model commands
Environment variables — AGTERM_DEFAULT_*
Built-in defaults — Anthropic with Claude Sonnet

Validation

On startup, AGTerm validates:

AGTERM_SECRET is set in production
AGTERM_PORT is a valid port (1-65535)
AGTERM_MAX_SESSIONS is in range (1-1000)

Invalid configuration causes startup failure in production mode.

Available Themes

Theme ID	Description
`agterm-dark`	Default dark theme
`agterm-light`	Light theme
`dracula`	Popular dark theme
`nord`	Arctic color palette
`tokyo-night`	Tokyo Night colors
`catppuccin-mocha`	Catppuccin dark
`monokai-pro`	Monokai Pro colors
`cyberpunk-neon`	Vibrant neon colors
`pergamon-dark`	Custom dark theme
`pergamon-blue`	Blue accent theme
`pergamon-light`	Light theme variant

Query available themes:

curl http://localhost:3000/api/themes