Skip to content

Config Command

The config command allows you to view and modify Terminal Agent's configuration settings.

Usage

agent config <subcommand> [args]

Subcommands

get

Get the value of a specific configuration setting:

agent config get <key>

get all

Get all configuration settings:

agent config get all

set

Set a configuration value:

agent config set <key> <value>

Configuration Keys

Key Description Example Values
provider The LLM provider to use openai, codex, anthropic, bedrock, google, ollama, llama
model The model ID to use gpt-4o-mini, claude-3-haiku-20240307, etc.
device Runtime device preference for direct llama provider auto, cpu, gpu
mcp-path Path to MCP JSON file /path/to/mcp.json

Examples

# Set the provider to OpenAI
agent config set provider openai

# Set the model to GPT-4o Mini
agent config set model gpt-4o-mini

# Prefer CPU for direct llama inference
agent config set device cpu

# Check the current provider
agent config get provider

# Check the current model
agent config get model

# Check the current device preference
agent config get device

# Set the MCP file path
agent config set mcp-path /home/user/mcp.json

# View all configuration settings
agent config get all

Configuration File

The configuration is stored in a JSON file at:

$HOME/.config/terminal-agent/config.json

While you can edit this file directly, it's recommended to use the config command to ensure proper formatting.

Provider-Specific Configuration

Different providers may require different model IDs. Here are some common examples:

OpenAI

agent config set provider openai
agent config set model gpt-4o-mini

Anthropic

agent config set provider anthropic
agent config set model claude-3-5-sonnet-latest

Amazon Bedrock

agent config set provider bedrock
agent config set model zai.glm-4.7-flash

Google

agent config set provider google
agent config set model gemini-3.1-flash-lite

Ollama

agent config set provider ollama
agent config set model llama3.2

Llama.cpp

agent config set provider llama
agent config set model llama3.2