Configuration

Environment Variables

All configuration lives in a .env file in the Wilson project root. Copy env.example to get started:

cp env.example .env

LLM Provider Keys

Set at least one provider API key. Wilson uses prefix-based routing to determine which provider handles a model:

Provider	Prefix	Environment Variable
OpenAI	gpt-	OPENAI_API_KEY
Anthropic	claude-	ANTHROPIC_API_KEY
Google	gemini-	GOOGLE_API_KEY
xAI	grok-	XAI_API_KEY
Moonshot	kimi-	MOONSHOT_API_KEY
DeepSeek	deepseek-	DEEPSEEK_API_KEY
OpenRouter	openrouter:	OPENROUTER_API_KEY
LiteLLM	litellm:	LITELLM_API_KEY
Ollama	ollama:	None (local)

Switch providers at any time during a session with the /model command.

Web Search Keys (optional)

Enable web search for merchant research and financial questions:

EXA_API_KEY=...
PERPLEXITY_API_KEY=...
TAVILY_API_KEY=...
BRAVE_API_KEY=...

Only one is needed. Wilson will use whichever key is available.

Ollama Configuration

OLLAMA_BASE_URL=http://localhost:11434   # default

Data Directory

Wilson stores all data in ~/.agentwilson/:

~/.agentwilson/
├── data.db           # SQLite database (all transactions)
├── mcp.json          # MCP server configuration
└── skills/           # User-installed skills

The database is a single SQLite file. Back it up by copying data.db.

MCP Servers

Add external tool servers in ~/.agentwilson/mcp.json:

{
  "servers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "my-mcp-server"],
      "env": {}
    }
  }
}

MCP tools appear automatically in Wilson’s tool registry. See MCP Integration for details.

Custom Skills

Drop a folder with a SKILL.md file into any of these directories:

Location	Purpose
src/skills/	Built-in skills (shipped with Wilson)
~/.agentwilson/skills/	User-wide skills
.agentwilson/skills/	Project-specific skills

Skills defined later in this list override earlier ones with the same name. See Custom Skills for the full guide.