DBinK/youarehere

You Are Here

一个 VS Code 扩展，把你 IDE 里选中的代码交给终端里的 CLI Agent。

Stars
Version
Installs
License
Agent Skills

简体中文 | English

简介

AI 编程 Agent 能读项目里的任何文件，却不知道你当前打开的是哪一个。要手动补上这个信息，就需要提供文件路径和行号区间，或者把代码粘贴过去。

这个扩展把当前文件、光标位置和选区写到一个固定路径，Agent 可以直接读。推荐用法是内置的两个 skill，它们遵循 Agent Skills 格式，Codex、Cursor、Gemini CLI、opencode、GitHub Copilot、Cline、Windsurf、Zed 等约 70 个 Agent 都能用。CLI Agent 最需要它——它们看不到你的编辑器，而窗口内的 Agent 本来就能自己拿到选区。

快速开始

1. 安装 VS Code 扩展——从 Visual Studio Marketplace 或 Open VSX 安装，开发阶段也可以从 VSIX 装（见开发）。

2. 安装 skills

npx skills add DBinK/youarehere -g

-g 会装进检测到的每个受支持 Agent 的用户级 skills 目录；不加则装进当前项目。如果 skills 装不了，让 Agent 从 https://github.com/DBinK/youarehere 安装。

扩展与 skills 用同一个版本号。装完首次启动会弹一个提示，点「立即更新」把 skills 对齐到这个版本即可；细节见版本提示。

3. 让 Agent 读取选区

在 VS Code 里选中代码，把 /here 和问题一起发给 Agent。以 Codex 为例：

/here 这个循环为什么跳过最后一个元素？

读了 src/parser.ts:42-58。循环上界是 i .vsix。本地安装：
bash
code --install-extension youarehere-.vsix --force

skills/ 目录不随 VSIX 打包，按快速开始里的方式从仓库安装。

发布

每个版本同时发到 Visual Studio Marketplace 和 Open VSX。两个命令都从环境变量读令牌，先导出。
bash
export VSCE_PAT=   # 需要 Marketplace > Manage 权限
export OVSX_PAT=

然后发布：
bash
npm run publish:vsce
npm run publish:ovsx

两个命令都会从源码打包再上传。首次发布前，Marketplace 上的 DBinK publisher 和 Open VSX 上的 DBinK namespace 必须已存在。Open VSX 建 namespace 用 npx ovsx create-namespace DBinK -p "$OVSX_PAT"。发布工具需要 Node.js 22 或更高版本。

致谢

灵感来自 yuichisuzuki0601/active-context-mcp。

许可证

MIT