/github-secrets-cli

A command line tool for managing Github project secrets

Primary LanguageTypeScriptApache License 2.0Apache-2.0

github-secrets-cli

A CLI based GitHub Secrets Manager.

oclif Version Downloads/week License

ghs provides a command line interface to manage GitHub Secrets for your projects.

Note: You will need a GitHub Personal Access Token with the repo scope. Detailed instructions available in their docs
You can Click Here to quickly set up a key with the required permissions.

Usage

$ npm install -g @anomalyhq/github-secrets-cli
$ ghs COMMAND
running command...
$ ghs (-v|--version|version)
@anomalyhq/github-secrets-cli/1.0.1 darwin-x64 node-v12.10.0
$ ghs --help [COMMAND]
USAGE
  $ ghs COMMAND
...

Commands

ghs config:get

Outputs your configuration.

USAGE
  $ ghs config:get

See code: src/commands/config/get.ts

ghs config:set

Update you configuration

USAGE
  $ ghs config:set

OPTIONS
  -o, --org=org                                  Organisation the repo belongs to.
  -r, --repo=repo                                Name of the repo.
  -t, --personalAccessToken=personalAccessToken  Your GitHub Personal Access Token.

See code: src/commands/config/set.ts

ghs help [COMMAND]

display help for ghs

USAGE
  $ ghs help [COMMAND]

ARGUMENTS
  COMMAND  command to show help for

OPTIONS
  --all  see all commands in CLI

See code: @oclif/plugin-help

ghs secrets:get

Fetch a list os set secrets (cannot read secret values)

USAGE
  $ ghs secrets:get

OPTIONS
  -h, --help                                     show CLI help
  -o, --org=org                                  Organisation the repo belongs to.
  -r, --repo=repo                                Name of the repo.
  -t, --personalAccessToken=personalAccessToken  Your GitHub Personal Access Token.

See code: src/commands/secrets/get.ts

ghs secrets:set

Update/Create a secret

USAGE
  $ ghs secrets:set

OPTIONS
  -b, --base64                                   base64 the string before encoding
  -f, --file=file                                Location of a file to create a secret from
  -h, --help                                     show CLI help
  -i, --input=input                              String to create a secret from
  -o, --org=org                                  Organisation the repo belongs to.
  -r, --repo=repo                                Name of the repo.
  -s, --secret=secret                            (required) GitHub Secret to update/create
  -t, --personalAccessToken=personalAccessToken  Your GitHub Personal Access Token.

See code: src/commands/secrets/set.ts

License

Distributed under the Apache 2.0 License. See LICENSE for further information.