.loopover-miner.env.example

# loopover-miner — starter env file
#
# Copy this to `.loopover-miner.env` (gitignored), fill in GITHUB_TOKEN, then either `source` it or
# point docker-compose / systemd at it — see packages/loopover-miner/DEPLOYMENT.md:
#
#   cp .loopover-miner.env.example .loopover-miner.env
#
# Every value below is a SAMPLE placeholder — never commit real secrets. For the generated,
# always-current table of every miner env var and its default, see
# packages/loopover-miner/docs/env-reference.md (regenerate with `npm run miner:env-reference`).

# =============================================================================
# 1. Required
# =============================================================================
# GitHub token (a PAT or an App installation token) the miner uses for issue discovery and PR-outcome
# polling. Discovery/attempt runs that reach GitHub fail without it. Keep it out of source control.
GITHUB_TOKEN=ghp_your_token_here
# Docker Swarm/Kubernetes secret-mount alternative: set GITHUB_TOKEN_FILE to a mounted file path instead
# of a plaintext value above (keeps the token out of `docker inspect`); an explicit GITHUB_TOKEN always
# wins if both are set. See packages/loopover-miner/DEPLOYMENT.md's "Secret-file alternative" section.
# GITHUB_TOKEN_FILE=/run/secrets/github_token

# =============================================================================
# 2. Coding agent
# =============================================================================
# Which local coding-agent CLI the miner drives for attempts (e.g. claude-code, codex). Leave unset to
# use the package default resolved at run time.
# MINER_CODING_AGENT_PROVIDER=claude-code

# =============================================================================
# 3. Optional overrides — defaults are fine for a single-machine install
# =============================================================================
# By default all local state lives under LOOPOVER_MINER_CONFIG_DIR (else $XDG_CONFIG_HOME, else
# ~/.config), in a loopover-miner/ subdirectory. Set the base dir, or any individual store path,
# only to relocate state (e.g. onto a dedicated volume).
# LOOPOVER_MINER_CONFIG_DIR=/var/lib/loopover-miner

# Repo clones and git worktrees created during attempts:
# LOOPOVER_MINER_REPO_CLONE_DIR=/var/lib/loopover-miner/clones
# LOOPOVER_MINER_WORKTREE_DIR=/var/lib/loopover-miner/worktrees

# Per-store SQLite file overrides (each defaults to a file under the config dir above):
# LOOPOVER_MINER_CLAIM_LEDGER_DB=
# LOOPOVER_MINER_PORTFOLIO_QUEUE_DB=
# LOOPOVER_MINER_EVENT_LEDGER_DB=
# LOOPOVER_MINER_RUN_STATE_DB=
# LOOPOVER_MINER_PLAN_STORE_DB=
# LOOPOVER_MINER_PREDICTION_LEDGER_DB=
# LOOPOVER_MINER_GOVERNOR_LEDGER_DB=
# LOOPOVER_MINER_GOVERNOR_STATE_DB=
# LOOPOVER_MINER_ATTEMPT_LOG_DB=
# LOOPOVER_MINER_ORB_EXPORT_DB=
# LOOPOVER_MINER_REPLAY_SNAPSHOT_DB=
# LOOPOVER_MINER_WORKTREE_ALLOCATOR_DB=
# LOOPOVER_MINER_DENY_HOOK_SYNTHESIS_DB=

# Misc:
# LOOPOVER_MINER_AMS_POLICY_PATH=          # path to an AMS policy file
# LOOPOVER_MINER_NO_UPDATE_CHECK=1         # disable the startup npm-registry version nudge
# LOOPOVER_MINER_VERSION=                  # override the reported version (testing only)