From 7596e5399d4405995064e6d9438082e14fbefd3c Mon Sep 17 00:00:00 2001
From: Bjarn Bronsveld <bjarn@bronsveld.me>
Date: Mon, 21 Sep 2026 22:15:32 +0200
Subject: [PATCH] docs: explain team switching with profiles

---
 README.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/README.md b/README.md
index ae464d4..e3e304e 100644
--- a/README.md
+++ b/README.md
@@ -69,6 +69,23 @@ lettermint messages events MESSAGE_ID
 
 Use `--profile`, `--project`, or `--route` to override saved defaults for one command. See the [message guide](skills/lettermint-cli/references/messages.md) for JSON input, HTML, attachments, and content exports.
 
+### Switch teams
+
+Each profile belongs to one team. To connect another team, create a new profile and select that team in your browser:
+
+```sh
+lettermint auth login --name team-b
+```
+
+Login selects the new profile. To switch back to a saved profile, no logout is needed:
+
+```sh
+lettermint profiles list
+lettermint profiles use work
+```
+
+Each profile keeps its own project and route defaults. Use `--profile team-b` to select a different profile for one command.
+
 ## Local webhooks
 
 Start your local webhook handler, then forward events to it: