id       = "gopass"
name     = "gopass"
homepage = "https://www.gopass.pw/"
description = "The slightly more awesome standard Unix password manager for teams."
executables   = ["gopass"]

[dotfiles]

# gopass's upstream setup documentation says it creates its user config at
# $HOME/.config/gopass/config and its password store at
# $HOME/.local/share/gopass/stores/root. The store contains encrypted secrets,
# so it is carried as a credential subtree rather than an ordinary path.
# https://github.com/gopasspw/gopass#readme
paths = ["~/.config/gopass/config"]
exclude = []
secret = ["~/.local/share/gopass/stores/"]
side_effect = false

[commands]
format = 1
label = "gopass"
description = "Show or generate secrets in the password store. Other gopass commands are not covered."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.subcommand]]
path = ["show"]
label = "Show a secret"
description = "Print or copy an entry. Revision, QR and parsing options are included; fuzzy search can be disabled."

[[commands.subcommand.source]]
id = "doc"
kind = "manual"
url = "https://github.com/gopasspw/gopass/blob/master/docs/commands/show.md"
revision = "master 2026-10-27"
evidence = """
`--clip` | `-c` | Copy the password value into the clipboard and don't show the content.
`--alsoclip` | `-C` | Copy the password value into the clipboard and show the content.
`--qr` | | Encode the password field as a QR code and print it.
`--password` | `-o` | Display only the password.
`--revision` | `-r` | Display a specific revision of the entry.
`--noparsing` | `-n` | Do not parse the content, disable YAML and Key-Value functions.
`--nofuzzysearch` | | Do not start fuzzy search if the requested entry is not found.
`--nosync` | | Disable auto-sync for this invocation.
gopass show entry key
"""

[[commands.subcommand.field]]
id = "entry"
label = "Entry"
type = "string"
position = 0
sources = ["doc"]

[[commands.subcommand.field]]
id = "key"
label = "Key"
description = "Only for key-value or YAML secrets."
type = "string"
position = 1
sources = ["doc"]

[[commands.subcommand.field]]
id = "clip"
label = "Copy to clipboard only"
type = "boolean"
option = ["--clip", "-c"]
sources = ["doc"]

[[commands.subcommand.field]]
id = "alsoclip"
label = "Copy and show"
type = "boolean"
option = ["--alsoclip", "-C"]
sources = ["doc"]

[[commands.subcommand.field]]
id = "password"
label = "Password only"
type = "boolean"
option = ["--password", "-o"]
sources = ["doc"]

[[commands.subcommand.field]]
id = "qr"
label = "Show as QR code"
type = "boolean"
option = ["--qr"]
sources = ["doc"]

[[commands.subcommand.field]]
id = "revision"
label = "Revision"
type = "string"
option = ["--revision", "-r"]
sources = ["doc"]

[[commands.subcommand.field]]
id = "noparsing"
label = "Do not parse content"
type = "boolean"
option = ["--noparsing", "-n"]
sources = ["doc"]

[[commands.subcommand.field]]
id = "nofuzzysearch"
label = "No fuzzy search"
type = "boolean"
option = ["--nofuzzysearch"]
sources = ["doc"]

[[commands.subcommand.field]]
id = "nosync"
label = "No auto-sync"
type = "boolean"
option = ["--nosync"]
sources = ["doc"]

[[commands.subcommand.task]]
id = "copy"
label = "Copy password"
set = { clip = [true] }
fields = ["entry", "clip", "nosync"]
required = ["entry"]

[[commands.subcommand.task]]
id = "print"
label = "Print password only"
set = { password = [true] }
fields = ["entry", "key", "password", "qr", "nosync"]
required = ["entry"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["entry", "key", "clip", "alsoclip", "password", "qr"]

[[commands.subcommand.group]]
id = "advanced"
label = "Advanced"
fields = ["revision", "noparsing", "nofuzzysearch", "nosync"]

[[commands.subcommand]]
path = ["generate"]
label = "Generate a password"
description = "Create a new entry with a generated password. The xkcd word options are left out."

[[commands.subcommand.source]]
id = "doc"
kind = "manual"
url = "https://github.com/gopasspw/gopass/blob/master/docs/commands/generate.md"
revision = "master 2026-10-27"
evidence = """
gopass generate entry [length]
gopass generate entry key [length]
| `--clip`      | `-c`    | Copy the generated password into the clipboard.
| `--print`     | `-p`    | Print the generated password to the terminal. Default: false.
| `--force`     | `-f`    | Force overwriting an existing entry.
| `--edit`      | `-e`    | Generate a password and open the entry for editing in `$EDITOR`.
| `--generator` | `-g`    | Choose one of the available password generators, described below. Default: `cryptic`
| `--symbols`   | `-s`    | Include symbols in the generated password (default: `false`)
| `--strict`    |         | Ensure each requested character class is actually included.
"""

[[commands.subcommand.field]]
id = "entry"
label = "Entry name"
type = "string"
position = 0
sources = ["doc"]

[[commands.subcommand.field]]
id = "length"
label = "Length"
type = "integer"
position = 1
sources = ["doc"]

[[commands.subcommand.field]]
id = "clip"
label = "Copy to clipboard"
type = "boolean"
option = ["--clip", "-c"]
sources = ["doc"]

[[commands.subcommand.field]]
id = "print"
label = "Print password"
type = "boolean"
option = ["--print", "-p"]
sources = ["doc"]

[[commands.subcommand.field]]
id = "force"
label = "Overwrite existing entry"
type = "boolean"
option = ["--force", "-f"]
effect = "overwrite"
sources = ["doc"]

[[commands.subcommand.field]]
id = "edit"
label = "Edit afterwards"
type = "boolean"
option = ["--edit", "-e"]
sources = ["doc"]

[[commands.subcommand.field]]
id = "generator"
label = "Generator"
type = "string"
option = ["--generator", "-g"]
suggestions = [{ value = "cryptic", label = "Cryptic (default)" }]
sources = ["doc"]

[[commands.subcommand.field]]
id = "symbols"
label = "Include symbols"
type = "boolean"
option = ["--symbols", "-s"]
sources = ["doc"]

[[commands.subcommand.field]]
id = "strict"
label = "Strict character classes"
type = "boolean"
option = ["--strict"]
sources = ["doc"]

[[commands.subcommand.task]]
id = "new"
label = "New password"
fields = ["entry", "length", "symbols", "clip", "print"]
required = ["entry"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["entry", "length", "symbols", "clip", "print"]

[[commands.subcommand.group]]
id = "advanced"
label = "Advanced"
fields = ["force", "edit", "generator", "strict"]