[FEATURE] Support @ references for files in /add-dir directories

[Vwings]

Preflight Checklist

• I have searched existing requests and this feature hasn't been requested yet
• This is a single feature request (not multiple features)

Problem Statement

I often need to reference code from other local repositories, but Claude Code doesn't support using @ to reference files in directories added via /add-dir.
The current workflow requires me to manually type full absolute paths or read files first before I can reference them, which is tedious and error-prone.

Proposed Solution

I would like to be able to reference files from added directories using a prefix syntax like @workspace:alias/, while keeping @ for the current workspace. For example:

/add-dir /path/to/other-project as other
@workspace:other/src/utils.ts // reference from other project
@src/utils.ts // reference from current project

This prefix approach avoids conflicts with files in the current directory and clearly indicates the file is from another workspace.

Alternative Solutions

No response

Priority

Medium - Would be very helpful

Feature Category

CLI commands and flags

Use Case Example

No response

Additional Context

No response

[github-actions]

Found 2 possible duplicate issues:

1. [BUG] @ mentions don't work with additional directories include via add-dir command #7412
2. [FEATURE] Alias labels for Additional Directories #14065

This issue will be automatically closed as a duplicate in 3 days.

• If your issue is a duplicate, please close it and 👍 the existing issue instead
• To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

[Vwings]

Just wanted to chime in—this isn’t a duplicate! Using @ to reference /add-dir folders and being able to alias those folders feel tied together to me, not separate asks. I get there might be better ways to handle it, totally down to discuss whatever works best. But here’s the thing: if you add another directory and there’s duplicate file paths (same path in both the main workspace and the added one), the CLI gets confusing—you can’t tell which one it’s pointing to, and search results get messy. That’s why I thought aliases would help make things clearer. Figured bringing this up as a whole makes more sense than splitting it, but happy to hear other ideas!

[github-actions]

This issue has been inactive for 30 days. If the issue is still occurring, please comment to let us know. Otherwise, this issue will be automatically closed in 30 days for housekeeping purposes.

[simkimsia]

This is one of the reasons why Claude code is not my first choice fir writing code

We have a knowledge base in one repo and the actual code in another

And i need an easy way to add context from the knowledge base to work on the code repo

The easiest way I have found is antigravity and using .code-workspace and add additional paths so I can easily @ the file from the knowledge base

[lexruster-st]

Auto closed? Are you serious? You vibe coding 10x with all your AIs, right? What is the problem in fixing that CRITICAL bug in 2 months?

[theRelSaul]

I wanted to chime in that this would be a massively helpful feature, and should be relatively easy to implement at that.