filecard¶

filecard is a command-line program for storing structured notes about people. Each person is a card. A card holds facts, relationships, notes, and a timestamped event log. The vault — the file containing all cards — is encrypted with GnuPG. Decrypted data exists only in process memory.

Inspired by the Farley File concept from Robert A. Heinlein's Double Star.

What filecard is¶

• A personal address book with memory: not just contact data, but context — what you discussed, what matters to them, how they relate to others.
• An encrypted, local-first tool. No server, no account, no network connection required.
• A terminal application. The interface is full-screen, keyboard-driven, and designed to be fast.

What filecard is not¶

• A contact sync tool. It does not integrate with phone contacts, CardDAV, or any external service.
• A notes application. It stores structured data about people, not arbitrary documents.
• A multi-user system. One vault, one GnuPG key, one person.

Design principles¶

The program follows the BSD/Unix philosophy: one task, done well, with no unnecessary dependencies. The vault is a single encrypted JSON file. The interface has no mouse support. Configuration is minimal.

Encryption is handled entirely by the system gpg binary and the GnuPG agent. filecard does not implement cryptography.

Source and license¶

Source code is at codeberg.org/duras/filecard.

Licensed under the ISC licence.