syncweaver init host

Initialize a host repository with syncweaver boilerplate: workflow templates, lockfile stubs, and optional orchestrator registration.

Usage

Usage: syncweaver init host [OPTIONS]

  Initialize host repository boilerplate and orchestrator registration.

  This command creates or refreshes a host lockfile and syncweaver host GitHub
  Actions workflows in the current repository. By default, it also opens a
  pull request in the orchestrator repository to add this host to host
  registry metadata.

Options:
  --host-repo TEXT            Optional host repository override in OWNER/REPO
                              format. When omitted, syncweaver infers host
                              metadata from git origin.
  --orchestrator-repo TEXT    Optional orchestrator repository override in
                              OWNER/REPO format. When omitted, syncweaver
                              derives it from host metadata.
  --lockfile PATH             Path to lockfile in the host repository.
                              [default: .syncweaver-lock.json]
  --overwrite                 Overwrite existing lockfile and workflow
                              templates when present.
  --register / --no-register  Open a PR in orchestrator repo to add this host
                              to host-repositories.yml.
  --token TEXT                GitHub token used to register the host in
                              orchestrator repo. May also be set via
                              GITHUB_TOKEN or resolved from gh auth.
  --registry-path PATH        Path to host registry inside the orchestrator
                              repository.  [default: .github/host-
                              repositories.yml]
  --branch TEXT               Optional branch name for orchestrator
                              registration pull request.
  --base-ref TEXT             Optional base branch for orchestrator
                              registration pull request.
  --title TEXT                Optional orchestrator registration pull request
                              title.
  --body TEXT                 Optional orchestrator registration pull request
                              body.
  -h, --help                  Show this message and exit.

Examples

# Initialize the current directory as a host repository
syncweaver init host

# Initialize and register with an orchestrator
syncweaver init host --orchestrator OWNER/syncweaver-orchestrator