[FEATURE] Support project-relative file imports in global ~/.claude/CLAUDE.md
Preflight Checklist
- [x] I have searched existing requests and this feature hasn't been requested yet
- [x] This is a single feature request (not multiple features)
Problem Statement
The @file import syntax in ~/.claude/CLAUDE.md resolves paths relative to ~/.claude/, not the current project directory. This makes it impossible to globally configure imports that should apply to every project.
Proposed Solution
Add syntax to reference files relative to the current working directory (project root), for example:
# In ~/.claude/CLAUDE.md
@cwd:README.md
@cwd:docs/architecture.md
Or alternatively:
- @$CWD/README.md
- @project:README.md
Alternative Solutions
Does anyone have an idea how this could be accomplished in a different way?
Priority
Low - Nice to have
Feature Category
CLI commands and flags
Use Case Example
Most projects have a README.md that contains essential context: what the project does, how to set it up, key architectural decisions, and development workflows. This information is exactly what Claude needs to work effectively in a codebase.
Currently, to include README.md in context, users must either:
- Add
@README.mdto each project'sCLAUDE.mdorCLAUDE.local.md— tedious and repetitive - Manually reference the README in conversation — repetitive
Additional Context
_No response_
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗