# cc-steer pipeline install-launchd


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


``` bash
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.


<span class="gd-details-chevron" aria-hidden="true"></span>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.