From 36b32500ec3b127f686e242ce8b1ce753ee8e793 Mon Sep 17 00:00:00 2001
From: Rob Zolkos <rob@zolkos.com>
Date: Mon, 1 Jun 2026 14:43:07 -0400
Subject: [PATCH] docs: document multiple identity profiles

---
 README.md                | 12 ++++++++++++
 skills/basecamp/SKILL.md |  1 +
 2 files changed, 13 insertions(+)

diff --git a/README.md b/README.md
index 84a51fcc..2d902b81 100644
--- a/README.md
+++ b/README.md
@@ -119,6 +119,18 @@ basecamp auth login --scope full # Full read+write access (BC3 OAuth only)
 basecamp auth token              # Print token for scripts
 ```
 
+### Multiple Identities
+
+Use named profiles when the same machine or agent gateway needs more than one Basecamp identity. Each profile has its own stored OAuth credentials and can be selected per command:
+
+```bash
+basecamp profile create design-agent
+basecamp profile create ops-agent
+basecamp --profile design-agent todo "Fix bug" --in 12345 --list 67890
+```
+
+Set a default with `basecamp profile set-default <name>`, or set `BASECAMP_PROFILE=<name>` for a process. Actions are posted as the authenticated user for the selected profile.
+
 ### Custom OAuth Credentials
 
 To use your own OAuth app (e.g., a custom Launchpad integration):
diff --git a/skills/basecamp/SKILL.md b/skills/basecamp/SKILL.md
index 3d2304eb..aac4734f 100644
--- a/skills/basecamp/SKILL.md
+++ b/skills/basecamp/SKILL.md
@@ -141,6 +141,7 @@ basecamp <cmd> --page 1     # First page only, no auto-pagination
 - `--assignee me` resolves to current user
 - `--due tomorrow` / `--due +3` / `--due "next week"` - natural date parsing
 - Project from `.basecamp/config.json` if `--in` not specified
+- Multiple identities use named profiles: `basecamp profile create <name>`, then select one with global `--profile <name>` or `BASECAMP_PROFILE=<name>`.
 
 ## Quick Reference