@davehardy20/pi-lsp-tools

Pi package for LSP-powered code navigation: goto definition, find references, diagnostics, symbols, and rename.

What it adds

Six LSP tools for Pi:

| Tool | Description | | --- | --- | | lsp_goto_definition | Jump to where a symbol is defined | | lsp_find_references | Find all references to a symbol across the workspace | | lsp_diagnostics | Get errors and warnings for a file | | lsp_symbols | List all symbols (functions, classes, variables) in a file | | lsp_prepare_rename | Check if a symbol can be renamed at a position | | lsp_rename | Rename a symbol across the workspace (applies changes) |

One command:

• /lsp-status — show package name, version, and loaded source path

Supported languages

The package ships built-in support for these language servers:

| Language | Server binary | File extensions | | --- | --- | --- | | TypeScript/JavaScript | typescript-language-server | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts | | Python | pyright-langserver | .py, .pyi | | Rust | rust-analyzer | .rs | | Go | gopls | .go | | Bash | bash-language-server | .sh, .bash, .zsh | | YAML | yaml-language-server | .yaml, .yml | | JSON | vscode-json-language-server | .json, .jsonc |

LSP runtime requirements

This package requires the language server binaries to be available in your PATH. It does not bundle the language servers themselves — they are external processes managed outside of Pi.

Auto-install

By default, the package attempts to auto-install missing language servers using npm install -g, rustup, or go install as appropriate. This can be disabled or configured via ~/.pi/lsp-config.yaml:

autoInstall: false

Manual install

# TypeScript
npm install -g typescript-language-server typescript

# Python
npm install -g pyright

# Rust
rustup component add rust-analyzer

# Go
go install golang.org/x/tools/gopls@latest

# Bash
npm install -g bash-language-server

# YAML
npm install -g yaml-language-server

# JSON
npm install -g vscode-langservers-extracted

Custom server configuration

You can override server commands or add custom servers in ~/.pi/lsp-config.yaml:

servers:
  typescript:
    command: ["my-custom-ts-server", "--stdio"]
    extensions: [".ts", ".tsx"]
  custom:
    command: ["my-lang-server"]
    extensions: [".xyz"]

Install

From npm:

pi install npm:@davehardy20/pi-lsp-tools

From git:

pi install git:github.com/davehardy20/pi-lsp-tools

From a local checkout during development:

pi install /Users/dave/tools/pi-lsp-tools

For one run only:

pi -e /Users/dave/tools/pi-lsp-tools

Settings

No Pi-level settings required. Language server configuration lives in ~/.pi/lsp-config.yaml.

Update flow

1. Update the package repo
2. Push to GitHub
3. Run pi update --extensions or reinstall the package
4. Run /reload

/reload alone does not fetch newer package commits.

Troubleshooting

Run /lsp-status to confirm:

• Package name and version
• Loaded source path

If LSP tools appear twice, Pi may be loading both the package and the old local extension. Disable or remove the old local auto-discovered extension before reload verification.

If a language server fails to start, check:

1. The server binary is installed and on your PATH
2. ~/.pi/lsp-config.yaml has correct server entries if customized
3. The workspace root contains a recognizable project marker (e.g. package.json, Cargo.toml, go.mod)

LSP runtime strategy

See docs/lsp-runtime-strategy.md for the explicit LSP runtime strategy covering server discovery, client lifecycle, auto-install, document synchronization, error handling, and cross-package coupling notes.

Build and test

npm run typecheck
npm run build
npm test

Package-local source layout

src/
├── index.ts              # Main extension entrypoint + tool registrations
├── lsp-client.ts         # JSON-RPC LSP client (vscode-jsonrpc)
├── lsp-service.ts        # Client cache, startup, shutdown
├── lsp-server-resolver.ts # File→server mapping + config from lsp-config.yaml
├── lsp-auto-installer.ts # Auto-installs missing language servers
├── lsp-utils.ts          # File filtering and grouping helpers
└── path-utils.ts         # Path normalization utilities

All helpers are package-local. This package does not import from ~/.pi/agent/extensions/shared/*.