# Pyright Lsp Tool

> On-demand Pyright LSP query tool (references) without running a full editor LSP.

- Skill: `kunhuang12345/pyright-lsp-tool` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add kunhuang12345/pyright-lsp-tool`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kunhuang12345/pyright-lsp-tool/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kunhuang12345 (https://skillmd.com/u/kunhuang12345)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kunhuang12345/pyright-lsp-tool

---


# pyright-lsp-tool

一个“可自由启停”的 Pyright LSP 小工具：需要查语义级引用时临时启动 `pyright-langserver`（或保持一段时间常驻），查询完成后退出即可。

本 skill **独立于其它 skill**，不读取/依赖 `ai-team-workflow` 或其它配置文件；其它 skill 也不应引用它。

## 依赖

- `pyright`（提供 `pyright-langserver`）
  - 推荐装到你的项目 venv：`pip install pyright`
- `node`（pyright 运行时需要）

## 用法

进入目标仓库根目录后运行（默认会用 `git rev-parse --show-toplevel` 作为 project root）：

- 交互模式（推荐：一次启动，多次查询；退出即停）
  - `python3 .codex/skills/pyright-lsp-tool/scripts/pyright_lsp_tool.py repl`
  - 在交互提示符里：
    - `refs src/pages/common/login_page.py:62:9`
  - 退出：`exit`

- 单次查询（每次都会启动一次 server，冷启动会慢一些）
  - `python3 .codex/skills/pyright-lsp-tool/scripts/pyright_lsp_tool.py refs src/pages/common/login_page.py:62:9`

可选参数：
- `--root <path>`：指定 project root（默认：git toplevel 或 cwd）
- `--venv <venv_dir>`：指定 venv（用于定位 `pyright-langserver`）