Skip to main content

Setup

PropertyValue
descriptionInstall, load-from-source, and profile-loader setup for MAC CLI.
relatedMAC CLI, Configuration, RepoHelpers, AuthHelpers, PowerShell, 1Password CLI
urlsGitHub Releases

MAC CLI is Windows-first and expects PowerShell 7.

The repo supports two normal setup models:

  • install from the published release ZIPs
  • load directly from repo source while developing or validating changes

Install From Release ZIPs​

Published release assets:

  • RepoHelpers-vX.Y.Z.zip
  • AuthHelpers-vX.Y.Z.zip
  • mac-cli-vX.Y.Z.zip
  • SHA256SUMS.txt

Recommended module install targets:

  • C:\Users\<user>\Documents\PowerShell\Modules\RepoHelpers\<version>\
  • C:\Users\<user>\Documents\PowerShell\Modules\AuthHelpers\<version>\

Use the combined mac-cli ZIP when both modules should land together. Use the per-module ZIPs when only one module needs to be installed or updated.

Load From Repo Source​

Standard local source-load pattern:

Remove-Module RepoHelpers -Force -ErrorAction SilentlyContinue

$env:REPO_HELPERS_CONFIG = 'D:\business\projects\mac-cli\RepoHelpers\Config\RepoHelpers.config.default.psd1'
Import-Module 'D:\business\projects\mac-cli\RepoHelpers\RepoHelpers.psd1' -Force
Set-Alias mac mac-cli

$env:AUTH_HELPERS_CONFIG = 'D:\business\projects\mac-cli\AuthHelpers\Config\AuthHelpers.config.default.psd1'

Quick verification:

Get-Command mac-cli
mac-cli help
mac-cli help commands
mac-cli man auth start-ai

Recommended profile pattern:

$env:REPO_HELPERS_CONFIG = 'C:\Users\circea\Documents\PowerShell\RepoHelpers.config.psd1'
Import-Module RepoHelpers -Force
Set-Alias mac mac-cli

$env:AUTH_HELPERS_CONFIG = 'C:\Users\circea\Documents\PowerShell\AuthHelpers.config.psd1'

Keep the real config files outside the repo. The tracked *.config.default.psd1 files are templates, not the intended live personal config location.

Default Shared Assumptions​

  • default workspace key = projects
  • default workspace path = D:\business\projects
  • default editor command = code
  • default AI provider = Codex

1Password And AI Launch Setup​

If the default auth hook pipeline is being used:

  • install the 1Password CLI
  • ensure op is available in PATH
  • keep the expected GitHub PAT @mcp item available, or override the item/field/env names in the AuthHelpers config

See the AuthHelpers section docs for the readiness, token-loading, and launch-flow details.