1diff --git a/plugins/ssh-agent/README.md b/plugins/ssh-agent/README.md
2index fa6a996d4aa07741a692e957368bc6d10ac5f360..8c118e65bfa0aaf1de5c11d4600ec287f3315312 100644
3--- a/plugins/ssh-agent/README.md
4+++ b/plugins/ssh-agent/README.md
5@@ -99,6 +99,33 @@ ssh-add -K -c -a /run/user/1000/ssh-auth <identities>
6 7 For valid `ssh-add` arguments run `ssh-add --help` or `man ssh-add`.
8 9+### Powerline 10k specific settings
10+
11+Powerline10k has an instant prompt setting that doesn't like when this plugin
12+writes to the console. Consider using the following settings if you're using
13+p10k (documented above):
14+
15+```
16+zstyle :omz:plugins:ssh-agent quiet yes
17+zstyle :omz:plugins:ssh-agent lazy yes
18+```
19+
20+### macOS specific settings
21+
22+macOS supports using passphrases stored in the keychain when adding identities
23+to the ssh-agent.
24+
25+```
26+ssh-add --apple-use-keychain ~/.ssh/id_rsa ...
27+```
28+
29+
30+This plugin can be configured to use the keychain when loading using the following:
31+
32+```
33+zstyle :omz:plugins:ssh-agent ssh-add-args --apple-load-keychain
34+```
35+
36 ## Credits
3738 Based on code from Joseph M. Reagle: https://www.cygwin.com/ml/cygwin/2001-06/msg00537.html