cc-steer pipeline install-launchd

Schedule the pass nightly — plus the weekly model retrain and the shadow watcher — via macOS LaunchAgents.

cc-steer pipeline install-launchd [OPTIONS]

The pipeline agent covers both collection cadences: it runs pipeline run --auto-weekly, so the Sunday pass folds in the auditor and eval. The retrain agent runs cc-steer retrain for the gate lane then the watcher lane every Sunday, refreshing each promoted model when its training data moved (--no-retrain skips it). The watch agent runs cc-steer watch continuously under KeepAlive so a fail-fast crash respawns (--no-watch skips it). Logs land under ~/.cc-steer/logs/. Re-running replaces the agents in place.

--prefix is shared by every agent. The bare default is version-pinned to this build’s wheel per agent — cc-steer==<installed> for the pipeline, cc-steer[retrain]==<installed> for the retrain watcher lane (Tinker + mlx-lm), cc-steer[gate,mlx]==<installed> for the watch daemon — so a launched agent resolves the exact build that scheduled it, the fix for the unpinned per-launch resolution that served an mlx-less env. A custom prefix must resolve its own extras and version.

Full --help output

Usage: cc-steer pipeline install-launchd [OPTIONS]

  Schedule the pass nightly — plus the weekly model retrain and the shadow
  watcher — via macOS LaunchAgents.

  The pipeline agent covers both collection cadences: it runs ``pipeline run
  --auto-weekly``, so the Sunday pass folds in the auditor and eval. The
  retrain agent runs ``cc-steer retrain`` for the gate lane then the watcher
  lane every Sunday, refreshing each promoted model when its training data
  moved (``--no-retrain`` skips it). The watch agent runs ``cc-steer watch``
  continuously under ``KeepAlive`` so a fail-fast crash respawns (``--no-
  watch`` skips it). Logs land under ``~/.cc-steer/logs/``. Re-running
  replaces the agents in place.

  ``--prefix`` is shared by every agent. The bare default is version-pinned to
  this build's wheel per agent — ``cc-steer==<installed>`` for the pipeline,
  ``cc-steer[retrain]==<installed>`` for the retrain watcher lane (Tinker +
  mlx-lm), ``cc-steer[gate,mlx]==<installed>`` for the watch daemon — so a
  launched agent resolves the exact build that scheduled it, the fix for the
  unpinned per-launch resolution that served an mlx-less env. A custom prefix
  must resolve its own extras and version.

Options:
  --prefix TEXT             Command prefix the agent invokes cc-steer with.
                            [default: uvx cc-steer]
  --journal-repo DIRECTORY  Repository whose cc-notes journal records each
                            pass.
  --hour INTEGER            Local hour the nightly pass fires at.  [default:
                            3]
  --retrain / --no-retrain  Also install the weekly gate + watcher retrain
                            agent.  [default: retrain]
  --retrain-hour INTEGER    Local hour the Sunday retrain fires at.  [default:
                            4]
  --watch / --no-watch      Also install the always-on watch daemon under
                            KeepAlive.  [default: watch]
  --help                    Show this message and exit.

Options

--prefix: TEXT = uvx cc-steer: Command prefix the agent invokes cc-steer with.
--journal-repo: DIRECTORY: Repository whose cc-notes journal records each pass.
--hour: INTEGER = 3: Local hour the nightly pass fires at.
--retrain, --no-retrain: Also install the weekly gate + watcher retrain agent.
--retrain-hour: INTEGER = 4: Local hour the Sunday retrain fires at.
--watch, --no-watch: Also install the always-on watch daemon under KeepAlive.