wednesday docs
Docs/Reference

Configuration

Everything lives on your machine. This page is the map of the state directory and the environment variables that override it.

Local data#

WhatWhere
Credentials~/.wednesday/.env
Teams (crews)~/.wednesday/state/crews.json
Task history~/.wednesday/state/tasks.json
Event log~/.wednesday/state/events.jsonl
Your skills~/.wednesday/skills/
MCP servers you attach~/.wednesday/state/mcp.json

Deleting ~/.wednesday/ removes the local profile. There is no copy on our side.

State and path overrides#

VariableEffect
WEDNESDAY_STATE_HOMEMoves the state directory.
HERMES_TASKS_PATHSelects the task store file.
FACTORY_EVENTS_PATHSelects the event log file.
WEDNESDAY_SKILLS_HOMEMoves the skills directory.

Model and provider variables#

VariableEffect
OPENROUTER_API_KEYOpenRouter key.
NVIDIA_API_KEYNVIDIA NIM key.
LOCAL_LLM_BASE_URLBase URL for a local OpenAI-compatible server.
LOCAL_LLM_MODELThe single model when no pool or crew slots are set.
FACTORY_MODEL_POOLComma-separated model ids, or id@baseURL.
FACTORY_RELAYSet to 1 to turn on team-up and capability routing.
FACTORY_LLM_PROVIDERThe route provider, for example local.
FACTORY_CREW_<SEAT>_MODELThe model for one seat (hyphens become underscores).
FACTORY_CREW_<SEAT>_BASE_URLThe endpoint for one seat.
FACTORY_MOASet to 1 to send a turn to several teammates and aggregate.
FACTORY_MOA_PROPOSERSComma-separated seats or models for the mixture.
FACTORY_MOA_AGGREGATORWho synthesises the final answer.
FACTORY_MAX_REPAIR_ATTEMPTSThe repair cap.
FACTORY_BUDGET_TOKENSToken ceiling for one run.
FACTORY_BUDGET_USDUSD ceiling for one run.
FACTORY_PRICE_<MODEL>USD per million tokens: input,output.

The .env file#

Keys and routes live in ~/.wednesday/.env, never in the repository. The file is read by the engine, and secret values are not printed in receipts or status output.

~/.wednesday/.env
OPENROUTER_API_KEY=...
LOCAL_LLM_BASE_URL=http://127.0.0.1:11434/v1
LOCAL_LLM_MODEL=qwen2.5-coder-3b-instruct
FACTORY_PRICE_QWEN_QWEN3_CODER=0.30,1.20

Do not commit this file. Do not paste a key into a task record or a chat message; the scan is a shape matcher, not a guarantee.