Skip to main content

CLI: vyasa governance


Usage: vyasa governance [OPTIONS] COMMAND [ARGS]...

Manage governance rules (rules that CHECK the work)

┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Commands ───────────────────────────────────────────────────────────────────┐
│ list Show all governance rules (inline + linked packs). │
│ use Use a rule source — one command to fetch, verify, and link it. │
│ update Update all linked rule sources to the latest (drift check). │
│ remove Stop using a rule source (unlink + remove connection). │
│ fetch Fetch a third-party rule pack via a connection and link it (power │
│ users). │
│ rules Edit inline governance rules (rules that CHECK the work) │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa governance list


Usage: vyasa governance list [OPTIONS]

Show all governance rules (inline + linked packs).

┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa governance use


Usage: vyasa governance use [OPTIONS] URI

Use a rule source — one command to fetch, verify, and link it.

┌─ Arguments ──────────────────────────────────────────────────────────────────┐
│ * uri TEXT Rule source URI: git+https://...@ref or file:///path │
│ [required] │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa governance update


Usage: vyasa governance update [OPTIONS]

Update all linked rule sources to the latest (drift check).

┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa governance remove


Usage: vyasa governance remove [OPTIONS] SOURCE

Stop using a rule source (unlink + remove connection).

┌─ Arguments ──────────────────────────────────────────────────────────────────┐
│ * source TEXT Rule source name to stop using [required] │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa governance fetch


Usage: vyasa governance fetch [OPTIONS]

Fetch a third-party rule pack via a connection and link it (power users).

┌─ Options ────────────────────────────────────────────────────────────────────┐
│ * --connection -c TEXT Connection ID to fetch from [required] │
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa governance rules


Usage: vyasa governance rules [OPTIONS] COMMAND [ARGS]...

Edit inline governance rules (rules that CHECK the work)

┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Commands ───────────────────────────────────────────────────────────────────┐
│ list Show inline governance rules. │
│ add Add an inline governance rule. │
│ remove Remove an inline governance rule by id. │
│ enable Enforce an inline governance rule (drops its enabled: False). │
│ disable Keep an inline governance rule without enforcing it. │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa governance rules list


Usage: vyasa governance rules list [OPTIONS]

Show inline governance rules.

┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa governance rules add


Usage: vyasa governance rules add [OPTIONS]

Add an inline governance rule.

┌─ Options ────────────────────────────────────────────────────────────────────┐
│ * --id TEXT Rule ID (e.g. 'my-org-rule') │
│ [required] │
│ * --operator -o TEXT Gate operator: FILES_MATCH | │
│ SECRET_SCAN | FIELD_EXISTS | ... │
│ [required] │
│ --severity -s TEXT error | warn [default: error] │
│ --name -n TEXT Human-readable name │
│ --field -f TEXT Glob pattern / frontmatter field │
│ --value -v TEXT Required regex / expected value │
│ --description -d TEXT What this rule checks │
│ --enabled --disabled Enforce the rule (disabled = kept │
│ but not enforced) │
│ [default: enabled] │
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa governance rules remove


Usage: vyasa governance rules remove [OPTIONS]

Remove an inline governance rule by id.

┌─ Options ────────────────────────────────────────────────────────────────────┐
│ * --id TEXT Rule ID to remove [required] │
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa governance rules enable


Usage: vyasa governance rules enable [OPTIONS]

Enforce an inline governance rule (drops its enabled: False).

┌─ Options ────────────────────────────────────────────────────────────────────┐
│ * --id TEXT Rule ID to enforce [required] │
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa governance rules disable


Usage: vyasa governance rules disable [OPTIONS]

Keep an inline governance rule without enforcing it.

┌─ Options ────────────────────────────────────────────────────────────────────┐
│ * --id TEXT Rule ID to keep without enforcing [required] │
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘