Revise README for improved clarity and structure

Brings ai-authorship note above the fold, and adds a note about imperfect isolation guarantee.

Signed-off-by: bdeshi <bdeshi@bdeshi.space>
This commit is contained in:
2026-08-06 01:06:12 +06:00
committed by GitHub
parent 8ea208ced4
commit 97b131070e
+24 -10
View File
@@ -1,14 +1,20 @@
![shannoncoat — which coat will Claude wear today?](docs/hero.png) ![shannoncoat — which coat will Claude wear today?](docs/hero.png)
Run multiple isolated Claude profiles on macOS — each one its own Claude Desktop Run multiple isolated [**\***](#isolation) Claude profiles on macOS — each one
**and** its own paired Claude Code setup — and tell their windows apart at a its own Claude Desktop **and** its own paired Claude Code setup — and tell their
glance. windows apart at a glance.
Your normal Claude install is left completely alone. It stays exactly as it is Your normal Claude install is left alone. It stays as it is and keeps working
and keeps working normally; shannoncoat only adds profiles alongside it. normally; shannoncoat only adds profiles alongside it.
A menu-bar item allows quick switching and profile management. A menu-bar item allows quick switching and profile management.
---
> [!NOTE]
> shannoncoat started as the shell script in the first commit, written by hand.
Claude built the GUI app out of it — most of the Swift, the icon, and this
README — working from human direction, review, and dogfooding.
## Requirements ## Requirements
- macOS 13 or later - macOS 13 or later
@@ -115,8 +121,12 @@ rather than killing Claude underneath it. Answer the dialog.
## Build from source ## Build from source
Requires the Xcode Command Line Tools. Local builds require the Xcode Command Line Tools.
```
xcode-select --install
```
Then run the build script
```bash ```bash
./build.sh ./build.sh
``` ```
@@ -129,8 +139,12 @@ every time, which silently invalidates its Accessibility grant on each rebuild.
`.env.example` walks through creating a self-signed certificate once so the `.env.example` walks through creating a self-signed certificate once so the
permission survives. permission survives.
--- ## Isolation
shannoncoat started as the shell script in the first commit, written by hand. > [!IMPORTANT]
Claude Code built the app out of it — most of the Swift, the icon, and this > Perfect isolation is not guaranteed. Claude and Claude Code can have functionally
README — working from direction, review and testing. > full disk access regardless of which profile it's running from, including access
> to default configuration folders.
>
> Some Claude integrations — skills, plugins, etc — may also hardcode the
> `~/.claude` path which may modify content in there.