Skip to content
okf-cli
GitHub

okf tags

Usage

Section titled “Usage”
usage: okf tags [-h] [--limit LIMIT] [--singletons] [--register TAG DESCRIPTION]
                [--validate TAG [TAG ...]] [--json]
                [query ...]


list all tags with usage counts, or fuzzy-search candidate tags


positional arguments:
  query                 candidate tag(s) to fuzzy-search against the tag universe; omit for full
                        audit dump


options:
  -h, --help            show this help message and exit
  --limit LIMIT         max matches per candidate (default 8)
  --singletons          full-dump mode only: show tags used exactly once
  --register TAG DESCRIPTION
                        add a tag to the TAGS.md registry (closed-vocabulary allow-list);
                        DESCRIPTION is required, max 150 chars; repeat the option for several tags
  --validate TAG [TAG ...]
                        check tag(s) against TAGS.md; exit 1 if any are unregistered
  --json                print one JSON envelope {command, ok, data, warnings, error}