Configuration reference

Every env var june reads, grouped by section. The Ctrl-F page. Source of truth: src/config.mjs.

Env vars are loaded in this order (first-set wins):

1. process.env as inherited from the shell / process supervisor.
2. ~/.config/june/.env — written by jun setup, the canonical location for global installs.
3. <repo>/.env — fallback for the git clone && npm link flow.

process.env beats every file. Use the XDG file for normal installs; use launchd / systemd / Docker --env-file to inject in production.

jun config show prints the resolved value of every key below and which file each came from. jun config edit opens the .env in $EDITOR.

Required

For the setup scripts (register-webhook, ensure-states, ensure-labels, acceptance:live) and the waiting sweep, JUNE_TEAM_KEY is also required.

Network

Paths

Linear

Runner: Claude (default)

See concepts.md → Timeout triage and → Health watchdog for the behaviour.

Runner: Codex

Codex's model and effort come from codex config (its own persisted settings); june doesn't pin them. The codex label still forces xhigh and fast still forces medium via the label-modifier path inside the orchestrator.

Runner: OpenCode

OpenCode's model / agent / variant come from opencode config (its own persisted settings); june doesn't pin them.

Runner: Antigravity (gemini label)

The legacy Gemini CLI runner is still in the codebase as a rollback path but is not currently routed to. Its env vars (JUNE_GEMINI_BIN, JUNE_GEMINI_TIMEOUT_MS) are read for legacy callers but Google has deprecated the gemini CLI for non-Enterprise tiers on 2026-06-18.

Runner: Hermes

Hermes' provider and model come from ~/.hermes/config.toml; june doesn't pin them.

Routing labels

States

JUNE_*_STATES are all comma-separated lists of Linear workflow state names. The first match wins; matches are case-insensitive. The orchestrator looks each list up against the current team and falls back to a state type when no name matches.

Behaviour tuning

Admin

Defaults at a glance

If you want to bring everything up explicitly, here's a .env with every key set to its current default:

# Required
LINEAR_API_KEY=lin_api_...
LINEAR_WEBHOOK_SECRET=...

# Network
JUNE_PORT=8787
JUNE_HOST=127.0.0.1
# JUNE_PUBLIC_WEBHOOK_URL=
JUNE_ALLOW_UNSIGNED_WEBHOOKS=0

# Paths
# JUNE_APP_DIR=...       # defaults to the repo root
# JUNE_AGENT_ROOT=...    # defaults to process.cwd()
# JUNE_DB=<appDir>/data/agent.sqlite
# JUNE_LOG=<appDir>/logs/agent.log

# Linear
# JUNE_TEAM_KEY=ENG
# JUNE_BOT_USER_EMAILS=

# Run timeouts (apply to every runner; per-runner overrides win)
JUNE_RUN_TIMEOUT_MS=0

# Claude
JUNE_CLAUDE_BIN=claude
# claudeEffort is hardcoded to "max" — Claude doesn't persist /effort between
# runs, so the orchestrator passes --effort max every spawn. No env var.
JUNE_CLAUDE_TIMEOUT_MS=0
JUNE_CLAUDE_TRIAGE_ENABLED=1
JUNE_CLAUDE_TRIAGE_TIMEOUT_MS=300000
JUNE_CLAUDE_HEALTH_CHECK_INTERVAL_MS=900000
JUNE_CLAUDE_WATCHDOG_TIMEOUT_MS=120000
JUNE_CLAUDE_WATCHDOG_HARD_IDLE_MINUTES=25
JUNE_CLAUDE_POST_RESULT_GRACE_MS=30000

# Codex
JUNE_CODEX_BIN=codex
JUNE_CODEX_LABEL=codex

# OpenCode
JUNE_OPENCODE_BIN=opencode
JUNE_OPENCODE_LABEL=opencode
JUNE_OPENCODE_EXPORT_TIMEOUT_MS=30000

# Antigravity (gemini label)
JUNE_ANTIGRAVITY_BIN=agy
JUNE_GEMINI_LABEL=gemini

# Hermes
JUNE_HERMES_BIN=hermes
JUNE_HERMES_LABEL=hermes
JUNE_HERMES_TOOLSETS=terminal,web,skills,session_search,todo,code_execution

# Routing
JUNE_DEFAULT_RUNNER=claude
JUNE_GOAL_LABEL=goal

# States
JUNE_WORKING_STATES=Working,In Progress
JUNE_REVIEW_STATES=Ready for Review,Done
JUNE_BLOCKED_STATES=Blocked,Canceled
JUNE_WAITING_STATES=Waiting
JUNE_WAITING_FROM_STATES=Ready for Review

# Behaviour
JUNE_COMMENT_DEBOUNCE_MS=30000
JUNE_COMMENT_MAX_AUTO_FLUSHES=3
JUNE_PROGRESS_COMMENTS_ENABLED=1
JUNE_THREAD_REPLIES=0
JUNE_WAITING_SWEEP_ENABLED=1
JUNE_WAITING_SWEEP_INTERVAL_MS=300000
JUNE_WAITING_AFTER_MS=3600000

# Admin
# JUNE_ADMIN_TOKEN=

You almost certainly don't want all of these in your .env — jun setup writes the minimal shape and june fills in defaults from src/config.mjs at boot. Run jun config show to see what your install actually resolved to.

What's not here

These were env vars in earlier versions; they've been removed because the per-runner CLI is the canonical place to set them, and double-pinning was just noise:

• JUNE_CLAUDE_EFFORT — Claude Code doesn't persist /effort, so the orchestrator hardcodes --effort max per spawn. The xhigh / fast label modifiers still apply.
• JUNE_CODEX_EFFORT, JUNE_CODEX_MODEL — set via codex config instead.
• JUNE_OPENCODE_MODEL, JUNE_OPENCODE_AGENT, JUNE_OPENCODE_VARIANT — set via opencode config instead.
• JUNE_GEMINI_MODEL — Antigravity binds the model to the desktop session; the legacy gemini CLI is deprecated anyway.
• JUNE_HERMES_MODEL, JUNE_HERMES_PROVIDER — set in ~/.hermes/config.toml instead.