From 97a13a7a9a163bc75ff87fe638862efc91cb4e6b Mon Sep 17 00:00:00 2001
From: Michele Cereda <cereda.michele@gmail.com>
Date: Thu, 28 Apr 2022 00:47:23 +0200
Subject: [PATCH] Improved contents of keybase notes

---
 knowledge base/keybase.md | 47 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/knowledge base/keybase.md b/knowledge base/keybase.md
index 0963d97..d85f6c4 100644
--- a/knowledge base/keybase.md	
+++ b/knowledge base/keybase.md	
@@ -13,10 +13,28 @@ KEYBASE_DEVICENAME=$(hostname) keybase login --paperkey "paper key" -s
 
 # Establish a temporary device.
 keybase oneshot
+KEYBASE_USERNAME="user" KEYBASE_PAPERKEY="paper key ..." keybase oneshot
 
 # List git repositories.
 keybase git list
 
+# Run garbage collection on git repository.
+keybase git gc awesomerepo
+
+# Enable LFS support for a repository.
+# Run it from the repository's root.
+keybase git lfs-config
+
+# Clone a repository with LFS-enabled files.
+git clone --no-checkout keybase://private/user/repo \
+  && cd repo && keybase git lfs-config && cd - \
+  && git -C repo checkout -f HEAD
+
+# Import an existing repository in Keybase
+keybase git create repo \
+  && git clone --mirror https://github.com/user/repo /tmp/repo.git \
+  && git -C /tmp/repo.git push --mirror keybase://private/user/repo
+
 # Run as root.
 KEYBASE_ALLOW_ROOT=1 keybase oneshot
 ```
@@ -36,6 +54,28 @@ Options can also be controlled by setting the related environment variable to 1:
 | `-h`   | print this help text                                | -                    |
 | `-k`   | shut down all Keybase services                      | KEYBASE_KILL=1       |
 
+## Import an existing repository in Keybase
+
+Use the import form in [Keybase launches encrypted git], or:
+
+1. Create the remote repository:
+
+   ```shell
+   keybase git create dotfiles
+   ```
+
+1. Copy the existing repository to a temporary directory:
+
+   ```shell
+   git clone --mirror https://github.com/user/dotfiles _tmp.git
+   ```
+
+1. Push the contents of the old repository to the new one:
+
+   ```shell
+   git -C _tmp.git push --mirror keybase://private/user/dotfiles
+   ```
+
 ## Run as root
 
 Keybase shouldn't be run as the `root`, and by default it will fail with a message explaining it.  
@@ -65,6 +105,13 @@ In addition, ephemeral keys are **purged entirely** when closing the oneshot ses
 
 - [Website]
 - [Linux guide]
+- [Keybase LFS support]
+- [Keybase launches encrypted git]
+- [How to use Keybase to encrypt files on Linux]
 
 [linux guide]: https://book.keybase.io/guides/linux
 [website]: https://keybase.io/
+
+[how to use keybase to encrypt files on linux]: https://www.addictivetips.com/ubuntu-linux-tips/keybase-encrypt-files-linux/
+[keybase launches encrypted git]: https://keybase.io/blog/encrypted-git-for-everyone
+[keybase lfs support]: https://github.com/keybase/client/issues/8936