kosh search

Find a credential by fuzzy search and copy its secret to the clipboard. This is the default command.

kosh search [label] [user]

Arguments: zero, one or two.

Form	Behaviour
kosh search	Interactive: type to filter the vault live, enter to pick
kosh search <label>	Best match for the label query
kosh search <label> <user>	Best match with label and user scored separately

Notes

• Matching is approximate, so partial and misspelled queries still work — crat finds cart, gpat finds git_personal_access_token.
• Results are ranked mostly on how closely the label and user match, with recently and frequently used credentials nudged higher. Usage can never promote a credential above a closer match.
• Any argument that is not a known subcommand is passed here, which makes kosh github the same as kosh search github.
• The master password is requested only after a match is found.
• The secret goes to the clipboard, never to the terminal.
• Cancelling the interactive search reports operation aborted; it is not an error.

Examples

kosh search                  # pick a credential interactively
kosh search github           # search by label
kosh search github alice     # narrow the search with a user
kosh github alice            # shorthand — the search subcommand is implied

See also

• Adaptive Search Algorithm — the full scoring model
• Retrieving Credentials — typo and abbreviation matching