bupha

Appearance

Command-Line Help for bupha ​

This document contains the help content for the bupha command-line program.

Command Overview:

bupha ​

the oxpecker on your repo's back — headless CI

Usage: bupha [OPTIONS] <COMMAND>

Subcommands: ​
  • watch — Serve the webhook → queue → runner loop
  • init — Scaffold dagger CI in a repo (dagger init + pinned module + delegate). For the script runner, a ci.sh is enough
  • doctor — Check what the loaded config actually needs on this box
  • run — Run the pipeline locally — in the watched repo's dir, not cwd
  • deploy — Install-time helpers — no manual file copies
  • destroy — Teardown counterparts of deploy
  • runs — Recent finished runs (reads <worktree.base>/history.jsonl)
  • log — Raw run log — last N lines of history.jsonl
  • explain — Why a sha did/didn't run — history + queue + worktree state
Options: ​
  • --config <CONFIG> — Path to bupha.toml (default: ./bupha.toml or ~/.config/bupha/)

bupha watch ​

Serve the webhook → queue → runner loop

Usage: bupha watch

bupha init ​

Scaffold dagger CI in a repo (dagger init + pinned module + delegate). For the script runner, a ci.sh is enough

Usage: bupha init [DIR]

Arguments: ​

  • <DIR> — Repo dir to initialize (default: cwd)

    Default value: .

bupha doctor ​

Check what the loaded config actually needs on this box

Usage: bupha doctor

bupha run ​

Run the pipeline locally — in the watched repo's dir, not cwd

Usage: bupha run [FUNCTION]

Arguments: ​
  • <FUNCTION> — Function for the dagger runner (default: from config)

bupha deploy ​

Install-time helpers — no manual file copies

Usage: bupha deploy <COMMAND>

Subcommands: ​
  • service — Write + enable the systemd user unit (needs enable-linger for boot persistence)
  • webhook — Register/update the repo's push webhook via the REST API (token from env/keyring/env file — no gh dependency)
  • env — Seed ~/.config/bupha/env with the secret names
  • check — Verify the whole install: unit, secrets, hook, endpoint, token
  • release — One-time seed: cargo publish in dep order + tag {repo}-v{ver}. Explicit — publishing is the irreversible step in the flow

bupha deploy service ​

Write + enable the systemd user unit (needs enable-linger for boot persistence)

Usage: bupha deploy service [OPTIONS]

Options: ​
  • --no-start — Skip enable --now (write the file only)

bupha deploy webhook ​

Register/update the repo's push webhook via the REST API (token from env/keyring/env file — no gh dependency)

Usage: bupha deploy webhook

bupha deploy env ​

Seed ~/.config/bupha/env with the secret names

Usage: bupha deploy env

bupha deploy check ​

Verify the whole install: unit, secrets, hook, endpoint, token

Usage: bupha deploy check

bupha deploy release ​

One-time seed: cargo publish in dep order + tag {repo}-v{ver}. Explicit — publishing is the irreversible step in the flow

Usage: bupha deploy release [OPTIONS]

Options: ​
  • --dry-run — Print the publish order and tag without doing anything

bupha destroy ​

Teardown counterparts of deploy

Usage: bupha destroy <COMMAND>

Subcommands: ​
  • service — Disable + remove the systemd user unit
  • webhook — Delete the repo's webhook whose URL matches tunnel.public_url
  • worktrees — Remove detached worktrees and the persisted queue file

bupha destroy service ​

Disable + remove the systemd user unit

Usage: bupha destroy service

bupha destroy webhook ​

Delete the repo's webhook whose URL matches tunnel.public_url

Usage: bupha destroy webhook

bupha destroy worktrees ​

Remove detached worktrees and the persisted queue file

Usage: bupha destroy worktrees

bupha runs ​

Recent finished runs (reads <worktree.base>/history.jsonl)

Usage: bupha runs [REPO]

Arguments: ​
  • <REPO> — Filter to one repo ("owner/name")

bupha log ​

Raw run log — last N lines of history.jsonl

Usage: bupha log [OPTIONS]

Options: ​

  • -n, --n <N> — Lines to show

    Default value: 50

bupha explain ​

Why a sha did/didn't run — history + queue + worktree state

Usage: bupha explain <SHA>

Arguments: ​
  • <SHA> — The pushed sha (any prefix ≥ 4 chars)

This document was generated automatically by clap-markdown.