{"id":13707158,"url":"https://github.com/secrethub/secrethub-cli","last_synced_at":"2025-05-06T00:30:29.356Z","repository":{"id":34560765,"uuid":"162978984","full_name":"secrethub/secrethub-cli","owner":"secrethub","description":"A secrets management platform that every engineer can use with minimal code changes.","archived":true,"fork":false,"pushed_at":"2022-11-14T09:57:52.000Z","size":10736,"stargazers_count":136,"open_issues_count":11,"forks_count":21,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-04-27T16:45:22.050Z","etag":null,"topics":["cli","devops","go","golang","secret-management","secrets","secrets-management","security"],"latest_commit_sha":null,"homepage":"https://secrethub.io","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/secrethub.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-12-24T10:26:14.000Z","updated_at":"2025-02-19T11:49:45.000Z","dependencies_parsed_at":"2023-01-15T07:46:55.667Z","dependency_job_id":null,"html_url":"https://github.com/secrethub/secrethub-cli","commit_stats":null,"previous_names":[],"tags_count":40,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/secrethub%2Fsecrethub-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/secrethub%2Fsecrethub-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/secrethub%2Fsecrethub-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/secrethub%2Fsecrethub-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/secrethub","download_url":"https://codeload.github.com/secrethub/secrethub-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252598155,"owners_count":21774211,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","devops","go","golang","secret-management","secrets","secrets-management","security"],"created_at":"2024-08-02T22:01:22.640Z","updated_at":"2025-05-06T00:30:28.500Z","avatar_url":"https://github.com/secrethub.png","language":"Go","readme":"\u003chr/\u003e\n\u003cp align=\"center\"\u003e\n  \u003csub\u003e\u003cimg src=\"https://1password.com/img/logo-v1.svg\" alt=\"1Password\" width=\"20\" /\u003e\u003c/sub\u003e \u003cb\u003eSecretHub has joined 1Password!\u003c/b\u003e Find out more on the \u003ca href=\"https://secrethub.io/blog/secrethub-joins-1password/\"\u003eSecretHub blog\u003c/a\u003e. 🎉\n\u003c/p\u003e\n\u003chr/\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://secrethub.io/img/github-banner.png?v4\" alt=\"SecretHub\" width=\"400\"\u003e\n\u003c/p\u003e\n\u003cbr/\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://signup.secrethub.io/\"\u003e\u003cimg alt=\"Get Started\" src=\"https://secrethub.io/img/buttons/github/get-started.png?v1\" height=\"28\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://secrethub.io/docs/reference/cli/\"\u003e\u003cimg alt=\"View Docs\" src=\"https://secrethub.io/img/buttons/github/view-docs.png?v2\" height=\"28\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003cbr/\u003e\n\n# SecretHub CLI\n\n[![GoDoc](https://godoc.org/github.com/secrethub/secrethub-cli?status.svg)][godoc]\n[![CircleCI](https://circleci.com/gh/secrethub/secrethub-cli.svg?style=shield)][circle-ci]\n[![Go Report Card](https://goreportcard.com/badge/github.com/secrethub/secrethub-cli)][goreportcard]\n[![Version](https://img.shields.io/github/release/secrethub/secrethub-cli.svg)][latest-version]\n[![Discord](https://img.shields.io/badge/chat-on%20discord-7289da.svg?logo=discord)][discord]\n\nThe SecretHub CLI provides the command-line interface to interact with the SecretHub API.\n\n\u003e [SecretHub][secrethub] is a secrets management tool that works for every engineer. Securely provision passwords and keys throughout your entire stack with just a few lines of code.\n\n## Usage\n\nBelow you can find a selection of some of the most-used SecretHub commands. Run `secrethub --help` or the [CLI reference docs][cli-reference-docs] for a complete list of all commands.\n\n### Reading and writing secrets\n```sh\n$ secrethub read \u003cpath/to/secret\u003e\nPrint a secret to stdout.\n\n$ secrethub generate \u003cpath/to/secret\u003e\nGenerate a random value and store it as a new version of a secret\n\n$ secrethub write \u003cpath/to/secret\u003e\nAsk for a value to store as a secret.\n\n$ echo \"mysecret\" | secrethub write \u003cpath/to/secret\u003e\nStore a piped value as a secret.\n\n$ secrethub write -i \u003cfilename\u003e \u003cpath/to/secret\u003e\nStore the contents of a file as a secret.\n```\n\n### Provisioning your applications with secrets\n```sh\n$ export MYSECRET=secrethub://path/to/secret\n$ secrethub run -- \u003cexecutable/script\u003e\nAutomatically load secrets into environment variables and provide them to the wrapped executable or script.\n\n$ echo \"mysecret: {{path/to/secret}}\" | secrethub inject\nRead a configuration template from stdin and automatically inject secrets into it.\n```\n\n### Access control\n```sh\n$ secrethub service init \u003cnamespace\u003e/\u003crepo\u003e --permission \u003cdir\u003e:\u003cread/write/admin\u003e\nCreate a service account for the given repository and automatically grant read, write or admin permission on the given directory.\n\n$ secrethub acl set \u003cpath/to/directory\u003e \u003caccount-name\u003e \u003cread/write/admin\u003e\nGrant an account read, write or admin permission on a directory.\n\n$ secrethub repo revoke \u003cnamespace\u003e/\u003crepo\u003e \u003caccount-name\u003e\nRevoke an account's access to a repository.\n```\n\n## Integrations\n\nSecretHub integrates with all the tools you already know and love.\n\n\u003cp align=\"left\"\u003e\n  \u003cimg src=\"https://secrethub.io/img/features/integrations.png\" width=\"450px\" /\u003e\n\u003c/p\u003e\n\nCheck out the [Integrations](integrations) page to find out how SecretHub works with your tools.\n\n## Getting help\n\nCome chat with us on [Discord][discord] or email us at [support@secrethub.io](mailto:support@secrethub.io)\n\n## Development\n\nPull requests from the community are welcome.\nIf you'd like to contribute, please checkout [the contributing guidelines](./CONTRIBUTING.md).\n\n### Build\n\nTo build from source, having [Golang](https://golang.org) installed is required.\nTo build the binary in the current directory, run:\n\n```sh\nmake build\n```\n\n### Install\n\nTo install the binary in the [GOBIN](https://golang.org/cmd/go/#hdr-GOPATH_environment_variable) directory, run:\n\n```sh\nmake install\n```\n\n### Test\n\nRun all tests:\n\n    make test\n\nRun tests for one package:\n\n    go test ./internals/secrethub\n\nRun a single test:\n\n    go test ./internals/secrethub -run TestWriteCommand_Run\n\n\n\n[secrethub]: https://secrethub.io/\n[getting-started]: https://secrethub.io/docs/getting-started/\n[cli-reference-docs]: https://secrethub.io/docs/reference/cli/\n[integrations]: https://secrethub.io/integrations/\n[releases]: https://github.com/secrethub/secrethub-cli/releases\n[latest-version]: https://github.com/secrethub/secrethub-cli/releases/latest\n[godoc]: http://godoc.org/github.com/secrethub/secrethub-cli\n[goreportcard]: https://goreportcard.com/report/github.com/secrethub/secrethub-cli\n[circle-ci]: https://circleci.com/gh/secrethub/secrethub-cli\n[discord]: https://discord.gg/gyQXAFU\n","funding_links":[],"categories":["Go"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsecrethub%2Fsecrethub-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsecrethub%2Fsecrethub-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsecrethub%2Fsecrethub-cli/lists"}