diff --git a/README.md b/README.md
index 628e0ba..d19d436 100644
--- a/README.md
+++ b/README.md
@@ -3,6 +3,7 @@
 ```
 bin            > helpful shell scripts
 git            > global git config & aliases
+gnupg          > utilise gpg-agent for pgp crypto
 lftp           > sftp management
 mail           > mail config - mutt/mbsync/notmuch
 mpd            > music player daemon config
@@ -12,6 +13,7 @@ npm            > npm configuration (ha ha)
 nvim           > neovim config & plugins
 ssh            > safe-ish ssh config
 sway           > minimal tiling wm for naughty computers
+system         > linux-specific system configuration
 termite        > terminal colours & keyboard settings
 tmux           > tmux config
 wallpapers     > system wallpapers
diff --git a/gnupg/.gnupg/gpg-agent.conf b/gnupg/.gnupg/gpg-agent.conf
new file mode 100644
index 0000000..ba2f665
--- /dev/null
+++ b/gnupg/.gnupg/gpg-agent.conf
@@ -0,0 +1,14 @@
+# enable ssh + session caching (1 day)
+#enable-ssh-support
+#default-cache-ttl-ssh 86400
+#max-cache-ttl-ssh 86400
+
+# session caching (1 day)
+default-cache-ttl 86400
+max-cache-ttl 86400
+
+# set pin entry program
+pinentry-program /usr/bin/pinentry-curses
+
+# allow loopback to stdin
+allow-loopback-pinentry
diff --git a/system/etc/security/pam_env.conf b/system/etc/security/pam_env.conf
index 9917d81..f0f6301 100644
--- a/system/etc/security/pam_env.conf
+++ b/system/etc/security/pam_env.conf
@@ -1,4 +1,4 @@
-# This config file is from /etc/security/pam_env.conf
+# conform to XDG base directory specification
 XDG_DATA_HOME DEFAULT=@{HOME}/.local/share
 XDG_CONFIG_HOME DEFAULT=@{HOME}/.config
 XDG_CACHE_HOME DEFAULT=@{HOME}/.cache