forgekey 1.0.0

A fast, minimal password generator CLI built in Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

# 🔑 forgekey

[![CI](https://github.com/vmagueta/forge/actions/workflows/ci.yml/badge.svg)](https://github.com/vmagueta/forge/actions/workflows/ci.yml)
[![Crates.io](https://img.shields.io/crates/v/forgekey)](https://crates.io/crates/forgekey)
[![codecov](https://codecov.io/gh/vmagueta/forgekey/branch/main/graph/badge.svg)](https://codecov.io/gh/vmagueta/forgekey)
[![docs.rs](https://img.shields.io/docsrs/forgekey)](https://docs.rs/forgekey)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

A fast, minimal password generator CLI built in Rust.

## Installation

```bash
cargo install forgekey
```

## Usage

```bash
# Generate a password (default: 16 characters)
forgekey

# Custom length
forgekey --length 32

# Generate multiple passwords
forgekey -n 5

# Exclude symbols
forgekey --no-symbols

# Exclude numbers and uppercase
forgekey --no-numbers --no-uppercase

# Combine flags
forgekey -l 32 -n 5 --no-symbols

# Copy password to clipboard
forgekey -c

# Generate a passphrase (default: 4 words)
forgekey --passphrase

# Custom word count
forgekey --passphrase --words 6

# Custom separator
forgekey --passphrase --separator "_"

# Multiple passphrases
forgekey --passphrase -n 5
```

## Options

| Flag | Short | Description | Default |
|------|-------|-------------|---------|
| `--length` | `-l` | Password length | `16` |
| `--number` | `-n` | Number of passwords | `1` |
| `--no-symbols` | | Exclude symbols | `false` |
| `--no-numbers` | | Exclude numbers | `false` |
| `--no-uppercase` | | Exclude uppercase | `false` |
| `--copy` | `-c` | Copy password to clipboard | `false` |
| `--passphrase` | `-p` | Generate a passphrase | `false` |
| `--words` | `-w` | Number of words in passphrase | `4` |
| `--separator` | | Word separator | `-` |

## Passphrase generation

Passphrases are generated using the [EFF Long Wordlist](https://www.eff.org/dice) (7776 words), the same standard used by major password managers.

## Built with

- [clap](https://crates.io/crates/clap) — CLI argument parsing
- [rand](https://crates.io/crates/rand) — Cryptographically secure randomness
- [colored](https://crates.io/crates/colored) — Terminal colors

## Contributing

Contributions are welcome! Check out the [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines and ideas.

## License

MIT