{"id":28268678,"url":"https://github.com/alexssd7/cpass","last_synced_at":"2025-06-16T20:31:34.877Z","repository":{"id":199277333,"uuid":"702496334","full_name":"AlexSSD7/cpass","owner":"AlexSSD7","description":"🔑 A minimalist CLI random password generator focusing on convenience and security.","archived":false,"fork":false,"pushed_at":"2023-10-09T13:44:03.000Z","size":367,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-16T18:10:32.958Z","etag":null,"topics":["password-generator"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AlexSSD7.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-10-09T12:33:55.000Z","updated_at":"2024-11-02T00:16:30.000Z","dependencies_parsed_at":null,"dependency_job_id":"c50b79b0-1be0-40bd-afc4-4b67ad894474","html_url":"https://github.com/AlexSSD7/cpass","commit_stats":null,"previous_names":["alexssd7/cpass"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/AlexSSD7/cpass","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexSSD7%2Fcpass","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexSSD7%2Fcpass/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexSSD7%2Fcpass/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexSSD7%2Fcpass/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AlexSSD7","download_url":"https://codeload.github.com/AlexSSD7/cpass/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexSSD7%2Fcpass/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260232826,"owners_count":22978627,"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":["password-generator"],"created_at":"2025-05-20T15:13:14.563Z","updated_at":"2025-06-16T20:31:34.865Z","avatar_url":"https://github.com/AlexSSD7.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# cpass\n\nA minimalist CLI random password generator focusing on convenience and security.\n\n![Screenshot of the cpass usage example](./assets/screenshot.png)\n\n# ⭐ Features\n\n## Convenience\n\n`cpass` generates passwords the way you would do it for your own convenience.\n\nWhen generating a password, `cpass` takes a random lowercase string as a base and then applies modifications like making some letters uppercase, adding digits, or adding special characters.\n\n## Security\n\n`cpass` is coded with a security-first mindset. Upon generating the password, `cpass` will provide you with a security report containing minimum and maximum entropy bits, and the average of both being the realistic strength of the password.\n\n- **Minimum entropy** bits assume that the attacker knows that you used this utility specifically while also knowing the exact parameters you supplied.\n- **Maximum entropy** bits also imply that the attacker is aware of you using this utility, but in this case, it is assumed that the attacker supposes that you used random parameters.\n- ***Realistic* entropy** is the average between both. However, if the attacker doesn't know that this specific utility was used to generate the password, the absolute entropy is going to be higher.\n\n# 🔒 Security Considerations\n## Parameter Choice\n\nPlease do not copy someone's parameters or reuse existing ones. It's vital to ensure that the parameters are not easy to guess to maximize the security.\n\n# 💿 Installation\n\n## Using Go's `go install`\nAssuming that you have an existing Go installation, you should be able to access the `go install` command which will build the project from source and put it to `$GOPATH/bin` directory. By default, `$GOPATH` is `$HOME/go`.\n\nYou can run the following command to build and install `cpass`:\n```sh\ngo install github.com/AlexSSD7/cpass@latest\n```\n\nAfter that, you should be able to run `cpass`, or `~/go/bin/cpass` if you have not added `~/go/bin` to `$PATH`.\n\n## Package managers\n\nTODO.\n\n## Prebuilt binaries\n\nYou can find prebuilt binaries in [cpass GitHub Releases](https://github.com/AlexSSD7/cpass/releases).\n\n## Build from Source\nClone the repository using `git` and run `go build` to build the `cpass` binary.\n\n```sh\ngit clone https://github.com/AlexSSD7/cpass\ncd cpass\ngo build\n```\n\n# 🔧 Usage\n\nUsing `cpass` is as easy as starting it up. `cpass` is fully interactive, meaning that there are no command line options to worry about.\n\nUpon the startup, you will be asked to supply the parameters to use when generating the password. Here is an example of how everything is going to look like:\n```\nuser@pc:~$ cpass\ncpass v0.1.0 linux/amd64 go1.21.2. Copyright (c) 2023 The cpass Authors. Distributed under GNU GPL v3, this program comes with ABSOLUTELY NO WARRANTY.\nPassword length \u003e 14\nNumber of uppercase characters to include (ABCDE) \u003e 2 \nNumber of digit characters to include (01234) \u003e 1\nNumber of special characters to include (~!@#$) \u003e 1\n\nGenerated Password: wrfbajIwy!8Cdy\n\nEntropy (min/realistic/max bits): 64/76/88 (Good)\nuser@pc:~$\n```\n\n# ©️ Copyright and License\n\nCopyright (c) 2023 The cpass Authors.\n\nProvided under the GNU General Public License v3. The copy of the license is included in the LICENSE file.\n\nUse this `git` command to view the list of cpass Authors:\n```sh\ngit log --format='%aN \u003c%aE\u003e' | sort -uf\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexssd7%2Fcpass","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexssd7%2Fcpass","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexssd7%2Fcpass/lists"}