fix: more robust -p failure handling

See toolshed/abra#576

cli/catalogue/catalogue.go

@@ -4,6 +4,7 @@ import (
 	"encoding/json"
 	"fmt"
 	"io/ioutil"
+	"os"
 	"path"
 	"slices"
 
@@ -56,9 +57,17 @@ It is quite easy to get rate limited by Docker Hub when running this command.
 If you have a Hub account you can "docker login" and Abra will automatically
 use those details.
 
-Push your new release to git.coopcloud.tech with "--publish/-p". This requires
-that you have permission to git push to these repositories and have your SSH
-keys configured on your account.`),
+Publish your new release to git.coopcloud.tech with "--publish/-p". This
+requires that you have permission to git push to these repositories and have
+your SSH keys configured on your account. Enable ssh-agent and make sure to add
+your private key and enter your passphrase beforehand.
+
+    eval ` + "`ssh-agent`" + `
+    ssh-add ~/.ssh/<my-ssh-private-key-for-git-coopcloud-tech>`),
+	Example: `  # publish catalogue
+  eval ` + "`ssh-agent`" + `
+  ssh-add ~/.ssh/id_ed25519
+  abra catalogue generate -p`,
 	Args: cobra.RangeArgs(0, 1),
 	ValidArgsFunction: func(
 		cmd *cobra.Command,
@@ -72,6 +81,10 @@ keys configured on your account.`),
 			recipeName = args[0]
 		}
 
+		if os.Getenv("SSH_AUTH_SOCK") == "" {
+			log.Warn(i18n.G("ssh: SSH_AUTH_SOCK missing, --publish/-p will fail. see \"abra catalogue generate --help\""))
+		}
+
 		if recipeName != "" {
 			internal.ValidateRecipe(args, cmd.Name())
 		}