Configuration

HiveScanner stores all configuration in ~/.hivescanner/config.json. You can edit this file directly or use the /hive wizard.

Config Structure

{
  "version": 2,
  "poll_interval_seconds": 300,
  "queue_retention_days": 7,
  "user": {
    "username": "YOUR_USERNAME",
    "email": ""
  },
  "autonomy": {
    "enabled": false,
    "oncall_groups": [],
    "transports": {},
    "group_policies": {}
  },
  "scanners": {
    "github": { ... },
    "slack": { ... },
    "calendar": { ... },
    "git_status": { ... }
  }
}

Global Settings

Field	Default	Description
poll_interval_seconds	300	How often workers poll for updates (in seconds)
queue_retention_days	7	How long acknowledged/acted pollen is retained before pruning
user.username	—	Your username (used for filtering @mentions)
user.email	—	Your email (used for calendar matching)

Autonomy Settings

Triage autonomy is off by default. See Triage Autonomy for details.

Field	Default	Description
autonomy.enabled	false	Global kill switch for confirmed triage posts
autonomy.oncall_groups	[]	Exact destination IDs that may receive a confirmed post
autonomy.transports	{}	Trusted destination-to-transport configuration (currently Slack)
autonomy.group_policies	{}	Exact source/group matching, triage enablement, triggers, templates, and cooldown policy

Scanner Configuration

Each scanner has its own configuration block under scanners. See individual scanner pages for details:

• GitHub
• Git Status
• Calendar
• Google Chat
• Email
• WhatsApp
• Weather

Environment Variables

HiveScanner uses environment variables for secrets. Tokens are never stored in config files — only the env var name is saved.

Variable	Scanner	How to Get It
GITHUB_TOKEN	GitHub	Optional override for the required gh CLI; use gh auth login or create a PAT
SLACK_TOKEN	Slack	Create a Slack App
LINEAR_API_KEY	Linear	Linear API Settings
JIRA_TOKEN	Jira	Atlassian API Tokens
GITLAB_TOKEN	GitLab	GitLab Personal Access Tokens
PAGERDUTY_TOKEN	PagerDuty	PagerDuty API Access Keys
SENTRY_TOKEN	Sentry	Sentry Auth Tokens
NOTION_TOKEN	Notion	Notion Integrations
TELEGRAM_BOT_TOKEN	Telegram	@BotFather on Telegram
DISCORD_BOT_TOKEN	Discord	Discord Developer Portal

Set them in your shell profile (e.g., ~/.zshrc):

export GITHUB_TOKEN="ghp_xxxxxxxxxxxx"
export SLACK_TOKEN="xoxb-xxxxxxxxxxxx"