@-Reference Copy
English | Русский
English
Features
This extension copies @-references to files and line ranges, so you can paste them straight
into an AI chat instead of retyping paths and counting line numbers. It works with any tool that
resolves @path mentions — Claude, Cursor, and others.
| Where |
Menu item |
Clipboard |
| Right click a file or folder in the explorer |
Copy @-reference |
@src/app.ts |
| Right click in the editor |
Copy @-reference |
@src/app.ts |
| Right click a selection in the editor |
Copy @-reference with lines |
@src/app.ts:12-20 |
Line ranges use the terminal-clickable path:start-end form. A selection inside a single line
gives @src/app.ts:12. Selecting several files in the explorer copies one reference per line.
Extension Settings
This extension is controllable by the next setting:
atReference.pathStyle: how paths are written in copied references.
workspace-relative (default) — @src/app.tsabsolute — @/home/me/proj/src/app.ts
Files outside any open workspace folder always use the absolute path, since a relative one
would not resolve.
The extension's menu labels, setting description and status bar message follow VS Code's
display language automatically (a Russian language pack switches them to Russian).
Development
npm install
npm test # unit tests for reference formatting
npm run package # builds a .vsix package
Press F5 in VS Code to run the extension in a new Extension Development Host window.
Русский
Возможности
Расширение копирует @-ссылки на файлы и диапазоны строк, чтобы вставлять их прямо в чат с
AI вместо того, чтобы вручную набирать путь и считать номера строк. Работает с любым
инструментом, понимающим упоминания @путь — Claude, Cursor и другими.
| Где |
Пункт меню |
В буфере обмена |
| Правый клик по файлу или папке в проводнике |
Copy @-reference |
@src/app.ts |
| Правый клик в редакторе |
Copy @-reference |
@src/app.ts |
| Правый клик по выделению в редакторе |
Copy @-reference with lines |
@src/app.ts:12-20 |
Диапазон строк записывается в кликабельном для терминала виде путь:начало-конец. Выделение
внутри одной строки даёт @src/app.ts:12. При выборе нескольких файлов в проводнике
копируется по одной ссылке на строку.
Настройки расширения
Расширение управляется одной настройкой:
atReference.pathStyle: как записывается путь в скопированной ссылке.
workspace-relative (по умолчанию) — @src/app.tsabsolute — @/home/me/proj/src/app.ts
Для файлов вне открытой папки воркспейса всегда используется абсолютный путь, так как
относительный путь там не резолвится.
Названия пунктов меню, описание настройки и сообщение в статус-баре сами переключаются вслед
за языком интерфейса VS Code (при установленном русском language pack).
Разработка
npm install
npm test # юнит-тесты форматирования ссылок
npm run package # соберёт .vsix-пакет
F5 в VS Code запускает расширение в новом окне Extension Development Host.
