docs: clarify Cowork vs Claude Code settings file location#124
Merged
tobinsouth merged 1 commit intomainfrom Mar 18, 2026
Merged
docs: clarify Cowork vs Claude Code settings file location#124tobinsouth merged 1 commit intomainfrom
tobinsouth merged 1 commit intomainfrom
Conversation
The READMEs instructed users to place settings files in 'your project's .claude/ directory' — but Cowork has no project concept. Its .claude/ is ephemeral per-session app storage in ~/Library/Application Support/ that users can't practically access. Cowork users should instead place settings files in any folder shared with Cowork via the folder picker. The skill implementations already search freely with no hardcoded path, so this is purely a docs fix. Reported via Reddit: https://www.reddit.com/r/ClaudeCowork/comments/1rh875p/
tobinsouth
approved these changes
Mar 18, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
All three plugin READMEs instruct users to place settings files in
.claude/directories — but these are Cowork-first plugins (each README says "primarily designed for Cowork" on line 3), and that instruction doesn't work in Cowork.Why
.claude/doesn't work in Cowork: Cowork has no project concept. Its.claude/directory is ephemeral, per-session, app-managed storage in~/Library/Application Support/Claude/.../{sessionId}/.claude/— not a location users can practically place files in. The agent's cwd is an empty/sessions/{name}home.What Cowork users should do instead: Save the settings file in any folder shared with Cowork via the folder picker (mounted at
$HOME/mnt/{name}in the VM). The skill implementations already search freely with no hardcoded path, so they'll find it.Reported via Reddit: https://www.reddit.com/r/ClaudeCowork/comments/1rh875p/
Fix
Replaced the single-surface path instruction with a Cowork / Claude Code split:
.claude/directory (or the plugin-specific path, depending on the README).This is docs-only — no code changes needed. The skill implementations (
SKILL.md) already search freely.Files changed
legal/README.md— "Configure your playbook" section (legal.local.md)human-resources/README.md— "Settings" section (settings.local.json)sales/README.md— "Settings" section (settings.local.json)Conflicts note
PRs #119 (install command syntax) and #110 (legal jurisdiction disclaimer) also touch
legal/README.md, but in different sections — no textual overlap expected.