Skip to main content

Start AI

PropertyValue
descriptionProvider-based AI launch flow and pre-launch hook pipeline in AuthHelpers.
relatedAuthHelpers, AI Readiness, GitHub MCP Token, OpenAI Codex, Claude Code

mac-cli auth start-ai is the provider-based AI launch surface.

It resolves the provider/profile config, runs the configured pre-launch hook pipeline unless skipped, and launches the configured AI CLI unless -NoLaunch is specified.

Example Usage​

mac-cli auth start-ai
mac-cli auth start-ai -NoLaunch -Dry
mac-cli auth start-ai -NoLaunch -NoHooks -Pass
mac-cli auth start-ai -Provider Claude -NoLaunch
mac-cli auth start-ai -Hook mac-cli-auth-load-github-mcp-token -NoLaunch -Dry

Current Flow​

  1. resolve provider/profile config
  2. resolve launch command and arguments
  3. collect hook list or -Hook override
  4. run hooks unless -NoHooks is used
  5. launch the provider CLI unless -NoLaunch is used

Current Provider Model​

The tracked shared config ships with:

  • provider = Codex
  • profile = default
  • launch command = codex
  • hook list = mac-cli-auth-load-github-mcp-token

Current Maintainer Notes​

  • -Pass is the main inspection path when a structured launch plan or hook result set is needed
  • ContinueOnHookError is configured per profile
  • provider expansion should happen in config and docs, not by splitting the public command surface