Theme
Aa
← man.tcos.us gopher root · man.tcos.us
lu: · ·
HEERC(5)                          File Formats                         HEERC(5)

NAME
       heerc - per-operator shell environment for the HEE toolchain

SYNOPSIS
       ~/git/human-execution-engine/tooling/heerc

DESCRIPTION
       A POSIX shell fragment sourced by the operator's bash(1) startup, delib‐
       erately  minimal:  it  makes  bare hee resolve, and carries per-operator
       display preference. It is not a general dotfile —  aliases,  prompt  and
       other opinion stay in personal dotfiles.

       Sourced from dotfiles' .bashrc behind an existence guard, so an operator
       using dotfiles without this repo cloned is unaffected.

WHAT IT DOES
       PATH bootstrap
              Prepends  ~/.local/bin  if absent. Real trigger, 2026-08-26: PATH
              resolution depended on one operator's personal dotfiles happening
              to add that directory, and broke for a fresh homedir and for  any
              other identity.

       Governance reminder
              Prints  a  one-line  reminder to read prompts/PROMPTING_RULES.md.
              Real footgun, 2026-08-28: a session ran mutating git across three
              repos before reading rule 1 (never push directly to main).

VARIABLES
       HEE_STATUS_STYLE
              Status rendering for  every  HEE  tool:  icon  (default),  ascii,
              plain.  See hee-status(7).  Per-operator preference, which is why
              it lives in an rc file rather than being hardcoded.

NOT SET HERE
       Runtime   variables   consumed   by  individual  tools  —  HEE_REPO_DIR,
       HEE_CRED_PASS, HEE_DERIVED_DIRS — are passed per invocation  or  by  the
       calling  tool,  not  declared here.  This file stays PATH-and-preference
       only.

SEE ALSO
       hee(1), hee-status(7)

HEE                                2026-09-01                          HEERC(5)