Skip to main content
The config command group manages Forge configuration settings including default model, provider, and other preferences.

​
Usage

forge config [SUBCOMMAND] [OPTIONS]

​
Subcommands

​
set

Set a configuration value. 
forge config set <FIELD> <VALUE>
​
field
enum
required
Configuration field to set. Available fields:
  • model - The active model
  • provider - The active provider
forge config set model anthropic/claude-sonnet-4
forge config set provider OpenAI
​
value
string
required
Value to set for the configuration field.
forge config set model anthropic/claude-sonnet-4
forge config set provider OpenAI

​
get

Get a configuration value. 
forge config get <FIELD>
​
field
enum
required
Configuration field to get. Available fields:
  • model - The active model
  • provider - The active provider
forge config get model
forge config get provider
​
--porcelain
boolean
default:"false"
Output in machine-readable format.
forge config get model --porcelain

​
list

List all configuration values. 
forge config list
​
--porcelain
boolean
default:"false"
Output in machine-readable format.
forge config list --porcelain

​
Examples

​
Set Default Model

forge config set model anthropic/claude-sonnet-4
Example output: 
✓ Configuration updated
  model: anthropic/claude-sonnet-4

​
Set Default Provider

forge config set provider OpenAI
Example output: 
✓ Configuration updated
  provider: OpenAI

​
Get Current Model

forge config get model
Example output: 
Model: anthropic/claude-sonnet-4

​
List All Configuration

forge config list
Example output: 
Forge Configuration:

  model:    anthropic/claude-sonnet-4
  provider: OpenAI

​
Machine-Readable Output

Get configuration in JSON format: 
forge config list --porcelain
Example output: 
{
  "model": "anthropic/claude-sonnet-4",
  "provider": "OpenAI"
}
Get single field: 
forge config get model --porcelain
Example output: 
anthropic/claude-sonnet-4

​
Alternative Commands

You can also use the list command: 
forge list config
forge list configs

​
Configuration Fields

​
model

The default AI model to use for conversations. Format: provider/model-name 
forge config set model anthropic/claude-sonnet-4
forge config set model openai/gpt-4
forge config set model google/gemini-pro

​
provider

The default API provider to use. 
forge config set provider OpenAI
forge config set provider Anthropic
forge config set provider Google

​
Runtime Overrides

Configuration values can be overridden for a single session: 
forge --model anthropic/claude-sonnet-4 -p "Hello"
forge --provider OpenAI -p "Test"
These overrides don’t change the permanent configuration.

​
Configuration File

Configuration is stored in:
  • User config: ~/.config/forge/config.toml
  • Local config: ./.forge/config.toml
Local configuration takes precedence over user configuration.
  • forge info - View current configuration and environment
  • forge list model - List available models
  • forge list provider - List available providers
  • forge --model <MODEL> - Override model for a session
  • forge --provider <PROVIDER> - Override provider for a session

​
Notes

  • Configuration changes take effect immediately
  • Use runtime overrides (--model, --provider) for temporary changes
  • Configuration is stored per-user and can be project-specific

Build docs developers (and LLMs) love

Get started for freeTalk to us