Reconstruct KeePassGO repository

2026-03-29 11:04:38 -07:00
commit a2a8fcbd14
34 changed files with 14041 additions and 0 deletions
@@ -0,0 +1,64 @@
+# 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
+
+```bash
+go run .
+```
+
+Phone-sized preview:
+
+```bash
+go run . -mode phone
+```
+
+## Test
+
+```bash
+go test ./...
+go tool golangci-lint run ./...
+```
+
+KDBX security and KDF compatibility notes are documented in [`docs/kdbx-compatibility.md`](./docs/kdbx-compatibility.md).
+
+## Build
+
+Desktop build:
+
+```bash
+go build ./...
+```
+
+## Android Packaging
+
+KeePassGO uses Gio, so Android packaging is done with `gogio`.
+
+Install:
+
+```bash
+go install gioui.org/cmd/gogio@latest
+```
+
+Package:
+
+```bash
+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`](./docs/desktop-automation.md).