keepassgo/README.md

KeePassGO

KeePassGO is a Go-based KeePass-compatible password manager prototype targeting desktop first, with future Android support.

Current Capabilities

• KDBX load and save
• password, key-file, and composite master-key support in the storage layer
• WebDAV-backed open and save support in the session layer
• password generation profiles
• gRPC integration surface for trusted automation
• template, attachment, group, history, and recycle-bin persistence

Run

go run .

Phone-sized preview:

go run . -mode phone

Test

go test ./...
go tool golangci-lint run ./...

KDBX security and KDF compatibility notes are documented in docs/kdbx-compatibility.md.

Build

Desktop build:

go build ./...

Android Packaging

KeePassGO uses Gio, so Android packaging is done with gogio.

Install:

go install gioui.org/cmd/gogio@latest

Package:

gogio -target android .

You will need the Android SDK and NDK installed and configured for real device or release packaging.

Automation

Desktop automation is resolved through the secure gRPC API rather than synthetic auto-type. See docs/desktop-automation.md.