Configuration

Providers

With no provider configured, min-agent uses a built-in OpenRouter model (openrouter/free) — no configuration needed to get started. Run min-agent setup to add or switch to your own providers:

min-agent setup --type ollama
min-agent setup --type openai-compatible --url https://api.example.com/v1 --api-key "$KEY" --name groq --default-model llama-3.1-70b
min-agent setup --switch ollama
min-agent setup --remove groq        # Remove a provider
min-agent setup --context-window 8192 # Set the context window

• --type accepts openai-compatible, openai, or ollama
• With no flags, min-agent setup starts the interactive wizard

Providers in ~/.min-agent/config.json always take over the built-in preset.

Global config file

Global settings live in ~/.min-agent/config.json:

Key	Description
activeProvider	Active provider
defaultModel	Default model
sampling	Sampling parameters
permission	Confirmation mode
thinking	Thinking intensity
memory	Memory switch
sandbox	Sandbox policy
compaction	Compaction strategy
agent	Other agent settings

API keys live only in ~/.min-agent/config.json, never in project config.

Project-level config

Run min-agent init in a project to create .min-agent/config.json for that directory only. Project values override global ones; min-agent never creates .min-agent/ on its own.

min-agent init                 # Initialize in the project root
min-agent --permission ask --project   # Write the mode to project config

Project config keys

• disabledSkills / enabledSkills: enable or disable skills
• Optional: activeProvider / defaultModel / sampling / permission / thinking / memory / sandbox / compaction / agent

Common commands

Command	Description
min-agent setup	Add, switch, or remove providers
min-agent init	Initialize project-level .min-agent/
min-agent permission	View/set confirmation mode
min-agent sandbox	View/set sandbox policy
min-agent think	View/set thinking intensity
min-agent memory	View/set memory switch
min-agent ctx	View/set the Ollama context window
min-agent rules	View/edit the rules files
min-agent models	List available models