MCPcopy Index your code
hub / github.com/GGP1/kure

github.com/GGP1/kure @v1.3.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.3.0 ↗ · + Follow
732 symbols 3,122 edges 127 files 218 documented · 30%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

kure

PkgGoDev Go Report Card

Password manager for the command-line that aims to offer a secure and private way of operating with sensitive information by reducing the attack surface to its minimum expression.

Features

  • Cross-Platform: Linux, macOS, BSD, Windows and mobile supported.
  • Private: Self-hosted and completely offline, no connection is established with 3rd parties.
  • Secure: Each record is encrypted using AES-GCM with 256 bit key and a unique password derived using Argon2 (id version). The user's master password is never stored on disk, it's encrypted and temporarily held in-memory inside a protected buffer, which is destroyed immediately after use.
  • Sessions: Run multiple commands by entering the master password only once. They support setting a timeout and running custom scripts.
  • Portable: Both kure and its database compile to binary files and they can be easily carried around in an external device.
  • Easy-to-use: Intuitive, does not require advanced technical skills.

Usage

For further information and examples, visit docs/commands.

Overview

Installation

Pre-compiled binaries

Linux, macOS, BSD, Windows and mobile pre-compiled binaries can be downloaded here.

Homebrew (Tap)

brew install GGP1/tap/kure

Scoop (Windows)

scoop bucket add GGP1 https://github.com/GGP1/scoop-bucket.git
scoop install GGP1/kure

or

scoop install https://raw.githubusercontent.com/GGP1/scoop-bucket/master/bucket/kure.json

Docker

For details about persisting the information check the docker-compose.yml file.

docker run -it gastonpalomeque/kure sh

For a container with limited privileges and kernel capabilities, use:

docker run -it --security-opt=no-new-privileges --cap-drop=all gastonpalomeque/kure-secure sh

Mobile phones terminal emulators

curl -LO https://github.com/GGP1/kure/releases/download/{version}/{ARM64 file}
tar -xvf {ARM64 file}
mv kure $BIN_PATH

Compile from source

git clone https://github.com/GGP1/kure
cd kure
make install

Configuration

Out-of-the-box kure needs no configuration, it creates a file with the default configuration and the database at:

  • Linux, BSD: $HOME/.kure
  • Darwin: $HOME/.kure or /.kure
  • Windows: %USERPROFILE%/.kure

However, to store the configuration file elsewhere or use a different one, set the path to it in the KURE_CONFIG environment variable.

Head over to the configuration documentation for a detailed explanation of the configuration file and some samples.

[!Note] Linux and BSD systems require a utility to write to the clipboard. This could be xsel, xclip, wl-clipboard or the Termux:API add-on.

Documentation

Learn more about how kure works in the wiki.

License

This project is licensed under the Apache-2.0 license. See LICENSE.

Extension points exported contracts — how you extend this code

Record (Interface)
Record is an interface that all kure objects implement. [6 implementers]
db/db.go
RunEFunc (FuncType)
RunEFunc runs a cobra function returning an error.
commands/util.go

Core symbols most depended-on inside this repo

Set
called by 116
config/type.go
GetName
called by 55
db/db.go
Close
called by 43
commands/restore/log.go
Set
called by 38
config/config.go
Get
called by 28
config/type.go
Create
called by 26
db/entry/entry.go
Get
called by 19
db/entry/entry.go
Create
called by 19
db/file/file.go

Shape

Function 606
Method 75
Struct 47
FuncType 2
Interface 1
TypeAlias 1

Languages

Go100%

Modules by API surface

pb/file.pb.go25 symbols
commands/util.go21 symbols
db/file/file_test.go20 symbols
config/config.go18 symbols
commands/util_test.go18 symbols
pb/entry.pb.go16 symbols
pb/card.pb.go16 symbols
db/entry/entry_test.go16 symbols
db/db_test.go15 symbols
db/card/card_test.go15 symbols
pb/totp.pb.go13 symbols
db/totp/totp_test.go12 symbols

For agents

$ claude mcp add kure \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact