homebot.yml

homebot.yml

At the repo root. Every key is optional; unknown keys are errors, so typos don’t fail silently. ai is reserved for a later version: it is accepted and ignored. Must be .yml; a homebot.yaml gets a rename hint.

persona chooses homebot’s voice. name chooses an optional command name; the two settings are independent. See Personas and Naming your homebot. See Persona files for local voices. Before adding persona: or name:, update every machine that reads this repo to a build that has the persona commands. An older build either rejects one or both keys, and so does its background helper, or ignores persona: and stays neutral.

update chooses what the background helper does about new releases. Set it only after every machine that reads this repo runs v0.1.0 or later and has rerun homebot setup. See Install and update.

profiles:
  default: workstation       # used when `homebot unpack` gets no name
  hosts:
    laptop: workstation      # per-hostname override
    nas: server

autosave:
  commit: daily              # off | hourly | daily
  push: true

exports:                     # refreshed by the helper about once a day
  - name: brew
    out: manifests/{os}/Brewfile
    run: brew bundle dump --force --file={out}   # {out} in run: the command writes the file
  - name: apt
    on: linux
    out: manifests/linux/apt.txt
    run: apt-mark showmanual | sort              # no {out}: stdout is saved
    profiles: [workstation]  # optional: only hosts whose default profile is listed
  - name: apt-repos
    on: linux
    out: manifests/linux/apt-repos               # a folder: the command made one at {out}
    run: homebot action apt-repos --export {out}
  - name: apt                # same name, another profile: its own list
    on: linux
    out: manifests/server/apt.txt
    run: apt-mark showmanual | sort
    profiles: [server]

triage:
  watch: ["~/.config/*", "~/.*"]   # entries end in /* or /.*

limits:
  maxFileMB: 50              # commits with bigger files are refused

update: off                   # off | notify | auto; anything else loads as off, with a warning
persona: neatpik              # optional; none selects neutral wording
name: homebot                 # optional; homebot means no other command name

Keys

Voice and display environment

decisions.yml

Written by homebot triage when you answer “ignore”. Hand edits are fine. Globs work.

ignore:
  - "~/.cache"
  - "~/.config/google-chrome*"
  - "~/.zcompdump*"

Snoozes are per machine and live in $XDG_STATE_HOME/homebot/snooze.json, not here.

Generated key index

The index below follows the loader’s config.Keys table. It records each key’s type, default, allowed values, description and release.