foostore

This is an humble Go tool for text and binary document encryption. It uses AES-256-CBC by default and the initialization vector is generated from an user input PIN.

This is for my own use. So the documentation here may be lacking. But feel free to try out yourself or ask!

Features

• Works on MacOS, Linux and on Android via Termux.
• Encrypts and stores any type of documents and files (text, binary, etc). Meant for smaller files, such as text, PDFs, etc.
• All documents are stored in a Git repository.
• All file names are encrypted as well and kept in encrypted indices in the same Git repository.
• The indices are searchable through fzf, the fuzzy finder.
• The Git repository can be synchronized with N remote Git repositories (e.g. to two separate VMs for geo-redundancy).
• Text entries are edited using Helix (or any other $EDITOR)
• Clipboard support for MacOS and GNOME (Linux).
• Interactive foostore shell support.
• Can import and export documuments in batches.
• Can shred exported data again.

Fish Shell Integration

Tab completion and a ge shortcut wrapper are provided for the fish shell.

Install

./install-fish.sh
exec fish

This copies completions/foostore.fish to ~/.config/fish/completions/ and completions/ge.fish to ~/.config/fish/functions/.

Usage

# Tab-complete foostore subcommands
foostore <TAB>

# ge wrapper: no arguments → interactive shell
ge

# ge wrapper: bare term → treated as search
ge mypassword        # same as: foostore search mypassword

# ge wrapper: explicit commands pass through
ge cat mypassword
ge import file.txt backup/

Entry-name completion is gated on the PIN environment variable to avoid interactive PIN prompts during tab completion:

set -x PIN yourpin   # enable entry completion for this session
ge <TAB>
set -e PIN           # clear when done

See FISH_INTEGRATION.md for more details.

Interactive Picker UX

In interactive shell mode (foostore with no arguments), pressing Enter on an empty line opens an enhanced fuzzy picker.

• Enter: select entry (updates last)
• Ctrl-T: cat selected entry
• Ctrl-Y: paste selected entry
• Ctrl-O: open selected entry
• Ctrl-E: edit selected entry
• Esc: cancel picker

The preview is metadata-only (description/type/hash suffix). Decrypted secret content is not shown in the picker preview.

Optional picker customization:

# presets: bold (default), clean, neon, mono
export FOOSTORE_TUI_THEME=clean

# append raw extra fzf options
export FOOSTORE_FZF_OPTS="--cycle --no-mouse"

PIN entry uses masked feedback (*) and vi-style line editing.