@piex-dev/lsp

LSP extension for pi — diagnostics (incl. post-edit ERRORs), navigation, rename, code actions, format

Packages

Package details

extension

Install @piex-dev/lsp from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@piex-dev/lsp
Package
@piex-dev/lsp
Version
0.2.0
Published
Jul 19, 2026
Downloads
262/mo · 262/wk
Author
debugtalk
License
MIT
Types
extension
Size
64.9 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions/lsp.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

lsp

LSP（Language Server Protocol）扩展：注册 lsp 工具，并在 edit/write 成功后自动附加 ERROR 诊断。

深度解读

功能

  • lsp 工具：stdio JSON-RPC 客户端，按项目 rootMarkers 发现 server
  • ~50 个默认 server（defaults.json）：typescript、rust-analyzer、gopls、pyright、clangd、biome/eslint（linter）等
  • 导航：definition / type_definition / implementation / references / hover / symbols / workspace_symbols
  • 诊断：单文件聚合多 server；relatedInformation；写后自动 ERROR 反馈
  • 重构：rename（默认 preview）、code_actions（list / apply）
  • 格式化：format（写回磁盘）
  • 运维：status / reload；broken spawn 缓存；AbortSignal 超时取消

写后诊断（Phase 1）

edit / write（含 hashline 覆盖的 edit）成功后，扩展会：

  1. 解析改动路径
  2. 同步磁盘内容到 language server（didOpen / didChange）
  3. 等待 publishDiagnostics
  4. 将 ERROR 诊断（每文件最多 20 条）附在 tool 结果末尾

关闭：

export PI_LSP_DIAGNOSTICS_ON_EDIT=0

支持的 action

status, reload, diagnostics
definition, type_definition, implementation, references, hover
symbols, workspace_symbols
rename, code_actions, format

rename / code_actions

参数 说明
apply 默认 false（preview）；true 才写盘
new_name / symbol rename 新名称
index code_actions 应用时的 1-based 序号
query code_actions 按 title/kind 过滤

写盘后请 re-read 再继续 hashline 编辑（tag 会失效）。

架构

lsp.ts
├── LspClient          # JSON-RPC、open/sync、diagnostics wait、server requests
├── Config             # defaults.json（initOptions + settings + isLinter）
├── Router             # getServersForFile / primary vs linter
├── WorkspaceEdit      # TextEdit + documentChanges apply（限制在 cwd）
├── Post-edit hook     # tool_result on edit/write
└── defaults.json

安装

pi install npm:@piex-dev/lsp

前提条件

本机安装对应 language server，例如：

npm install -g typescript-language-server typescript
pip install pyright
rustup component add rust-analyzer
go install golang.org/x/tools/gopls@latest

which 会额外查找项目内 node_modules/.bin、.venv/bin。

与 omp / OpenCode 的差异

能力 omp OpenCode piex lsp
显式 lsp tool 14 action 实验 flag 13 action（默认开）
写后诊断 writethrough + deferred edit/write 注入 ERROR tool_result 附 ERROR（可关）
rename / codeAction ✅ ❌ ✅ preview 默认
多 server 诊断 ✅ ✅ ✅
isLinter 分流 ✅ 多 client ✅
TUI 渲染 ✅ 侧栏 status 纯文本
项目级 lsp 配置 多层 config.lsp 暂仅 defaults（后续）
lspmux / 自动下载 有 有 ❌

功能参考 oh-my-pi packages/coding-agent/src/lsp 与 OpenCode 写后诊断闭环。