Skip to main content

Configuration

PropertyValue
descriptionRepoHelpers and AuthHelpers configuration model for MAC CLI.
relatedSetup, RepoHelpers, AuthHelpers, PowerShell

MAC CLI uses two tracked default config files and expects real user-specific configs to live outside the repo.

Tracked defaults:

  • RepoHelpers/Config/RepoHelpers.config.default.psd1
  • AuthHelpers/Config/AuthHelpers.config.default.psd1

RepoHelpers Config Model​

The RepoHelpers config controls workspace selection, branch policy, GitHub defaults, editor defaults, automation text, and optional publish-connection settings.

Current Top-Level Keys​

  • DefaultWorkspace
  • Workspaces
  • BranchPolicy
  • GitHub
  • Editor
  • RepoPolicies
  • Automation

Current Shared Defaults​

  • DefaultWorkspace = 'projects'
  • Workspaces.projects = 'D:\business\projects'
  • work branch default = dev
  • release branch = main
  • protected branches = main
  • GitHub owner = thecirceaco
  • editor command default = code

Automation Model​

Automation currently owns:

  • generated commit/save/tag/release fallback text
  • release notes mode defaults
  • pull behavior defaults
  • optional publish connection config

The auto-generated text model supports placeholders such as:

  • {timestamp}
  • {repo}
  • {version}

AuthHelpers Config Model​

The AuthHelpers config is provider-based.

Current model:

  • Ai.DefaultProvider
  • Ai.Providers.<provider>.DefaultProfile
  • Ai.Providers.<provider>.Profiles.<name>.Command
  • Ai.Providers.<provider>.Profiles.<name>.Arguments
  • Ai.Providers.<provider>.Profiles.<name>.Hooks
  • Ai.Providers.<provider>.Profiles.<name>.HookParameters
  • Ai.Providers.<provider>.Profiles.<name>.ContinueOnHookError

Current Shared Defaults​

  • default provider = Codex
  • default profile = default
  • default launch command = codex
  • default hook list includes mac-cli-auth-load-github-mcp-token
  • default hook parameters target:
    • item = GitHub PAT @mcp
    • field = credential
    • env var = GITHUB_PAT_TOKEN

Override Model​

Common override patterns:

  • keep the real config outside the repo
  • point REPO_HELPERS_CONFIG and AUTH_HELPERS_CONFIG at the local config files
  • override the default editor command if another editor should open from mac-cli code
  • add alternate providers or profiles in AuthHelpers rather than branching the public command surface

Current Maintainer Rule​

When the config model changes:

  • update the quick docs in the repo
  • update the published MAC CLI product docs here
  • update the repo-local .codex maintainer context in the same task