Skip to main content

Configuration File

Terramind uses a configuration file to store your preferences and settings. The configuration is automatically created when you first run Terramind.

Location

The configuration file is located at:
  • macOS/Linux: ~/.config/terramind/config.json
  • Windows: %APPDATA%\terramind\config.json

Structure

Authentication

Configure authentication credentials for Terramind:

API Key

The recommended method for authentication:
Or set it in your environment:

Firebase Token

Alternative authentication method:
Keep your API keys secure! Never commit them to version control or share them publicly.

Model Settings

Default Model

Set your preferred default model:
Or via environment variable:

Model-Specific Settings

Configure settings for individual models:

Preferences

Theme

Choose your preferred color theme:

Output Format

Control how Terramind displays output:

Auto-Update

Control automatic updates:

Project Configuration

You can also create project-specific configuration files:

.terramind.json

Create a .terramind.json file in your project root:
This configuration will be used when running Terramind in that directory.

MCP Servers

Configure Model Context Protocol servers for extended capabilities:
Learn more in the MCP documentation.

Tool Configuration

Configure which tools Terramind can use:

Available Tools

  • bash - Execute shell commands
  • read - Read file contents
  • write - Write/modify files
  • grep - Search file contents
  • codesearch - Semantic code search
  • glob - File pattern matching
  • ls - List directory contents
  • webfetch - Fetch web content
  • websearch - Search the web

Logging

Configure logging behavior:
Or use environment variable:

Advanced Settings

Context Window

Control how much context is sent to the AI:

Caching

Configure response caching:

Network

Configure network settings:

Environment Variables

All configuration options can be overridden with environment variables:

Resetting Configuration

To reset to default settings:
The configuration will be recreated with defaults on next run.

Configuration Validation

Validate your configuration file:
This will check for syntax errors and invalid values.

Next Steps

CLI Commands

Explore all available commands

AI SDK Provider

Use Terramind in your code