diff --git a/docs/docs/pages/cli-reference.mdx b/docs/docs/pages/cli-reference.mdx
index fbb4674..d4b0ac8 100644
--- a/docs/docs/pages/cli-reference.mdx
+++ b/docs/docs/pages/cli-reference.mdx
@@ -1,10 +1,26 @@
 # CLI Reference
 
+## `login`
+
+```bash [Terminal]
+sequoia login
+> Login with OAuth (browser-based authentication)
+
+OPTIONS:
+  --logout <str> - Remove OAuth session for a specific DID [optional]
+
+FLAGS:
+  --list     - List all stored OAuth sessions [optional]
+  --help, -h - show help [optional]
+```
+
+OAuth is the recommended authentication method as it scopes permissions and refreshes tokens automatically. 
+
 ## `auth`
 
 ```bash [Terminal]
 sequoia auth
-> Authenticate with your ATProto PDS
+> Authenticate with your ATProto PDS using an app password
 
 OPTIONS:
   --logout <str> - Remove credentials for a specific identity (or all if only one exists) [optional]
@@ -14,6 +30,8 @@ FLAGS:
   --help, -h - show help [optional]
 ```
 
+Use this as an alternative to `login` when OAuth isn't available or for CI environments.
+
 ## `init`
 
 ```bash [Terminal]
diff --git a/docs/docs/pages/quickstart.mdx b/docs/docs/pages/quickstart.mdx
index 136098a..ac8cf21 100644
--- a/docs/docs/pages/quickstart.mdx
+++ b/docs/docs/pages/quickstart.mdx
@@ -31,18 +31,20 @@ Check to make sure it was installed correctly by running the `sequoia` command
 sequoia
 ```
 
-### Authorize
+### Login
 
-In order for Sequoia to publish or update records on your PDS, you need to authorize it with your ATProto handle and an app password.
-
-:::tip
-You can create an app password [here](https://bsky.app/settings/app-passwords)
-:::
+In order for Sequoia to publish or update records on your PDS, you need to authenticate with your ATProto account.
 
 ```bash [Terminal]
-sequoia auth
+sequoia login
 ```
 
+This will open your browser to complete OAuth authentication, and your sessions will refresh automatically as you use the CLI.
+
+:::tip
+Alternatively, you can use `sequoia auth` to authenticate with an [app password](https://bsky.app/settings/app-passwords) instead of OAuth.
+:::
+
 ### Initialize
 
 After you have authorized Sequoia, the next step is to setup your blog as a publication. First make sure you are in your main repo for your blog SSG, then run the following: