Configuration

Configuration precedence

From highest to lowest priority:

1. CLI flags (--port=8080)
2. Environment variables (WGL_PORT=8080)
3. Project config (.wglrc* in closest ancestor directory)
4. Global config (~/.wglrc*)
5. Defaults

First file found wins per directory level.

Config file formats

.wglrc.yaml

server: http://localhost:8080
namespace: default
agent_id: my-agent
profile: personal

.wglrc.json

{
  "server": "http://localhost:8080",
  "namespace": "default",
  "agent_id": "my-agent"
}

.wglrc (key=value)

server=http://localhost:8080
namespace=default
agent_id=my-agent

Environment variables

Variable	Config key	Description
WGL_SERVER	server	Incubator server URL
WGL_NAMESPACE	namespace	ACP namespace
WGL_AGENT_ID	agent_id	Agent identifier
WGL_PROFILE	profile	Auth profile name
TELEMETRY_ENDPOINT	—	Cloud telemetry ingest URL
TELEMETRY_API_KEY	—	Cloud telemetry API key

State directory (.honeyb/)

Runtime state lives in .honeyb/ (project-level) and ~/.honeyb/ (global).

Project state (.honeyb/)

.honeyb/
├── brood.state.json       # Running brood PIDs and ports
├── session/               # Active coordination session
└── logs/                  # JSONL log files

Global state (~/.honeyb/)

~/.honeyb/
├── auth/
│   ├── personal.json      # Auth profile: tokens, platform URL
│   └── work.json          # Additional profile
├── integrations/           # Installed integrations
├── servers/                # Known server configs
├── specs/                  # Downloaded protocol specs
├── dances/                 # Downloaded dance files
├── projects/
│   └── <slug>/
│       ├── telemetry/      # JSONL telemetry files
│       │   └── 2026-02-15.jsonl
│       └── logs/           # Project-specific logs
└── config.json             # Global preferences

Auth profiles

Created by wgl auth login. Stored in ~/.honeyb/auth/<profile>.json:

{
  "platform_url": "https://hivemind.honeyb.dev",
  "access_token": "...",
  "refresh_token": "...",
  "expires_at": "2026-03-15T00:00:00Z"
}

Switch profiles:

wgl auth switch
wgl config set profile work

The SDK uses createPlatformClient({ profile: 'personal' }). The platform URL should be https://hivemind.honeyb.dev (the SDK prepends api. for API calls).

Provider secrets

Local development

Provider API keys in ~/.secrets/*.env:

~/.secrets/cerebras.env

CEREBRAS_API_KEY=csk-...

# ~/.secrets/anthropic.env
ANTHROPIC_API_KEY=sk-ant-...

wgl up sources these automatically.

Cloud (Colony)

wgl secret set cerebras              # Prompts for key, stores in D1
wgl secret set cerebras --hive foo   # Hive-specific override

Resolution order: hive-specific → user-level → empty.