Back to search
alessioarcara-plugins
MarketplaceWorks with Claude CodeGitHub
Pyrefly language server plugin for Claude Code
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/alessioarcara--claude-pyrefly-lsp)HTML
<a href="/listings/alessioarcara--claude-pyrefly-lsp"><img src="/api/listings/alessioarcara--claude-pyrefly-lsp/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
claude plugin marketplace add alessioarcara/claude-pyrefly-lsp claude plugin install pyrefly-lsp@alessioarcara-plugins
Then restart Claude Code or run `/reload-plugins`. If `pyrefly` is not on your `PATH`, the plugin says so when a session starts.
If you have the official `pyright-lsp` plugin, disable it, so two servers do not both answer for the same files:
claude plugin disable pyright-lsp@claude-plugins-official
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 17 lines
- {
- "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
- "name": "alessioarcara-plugins",
- "description": "Pyrefly language server plugin for Claude Code",
- "owner": {
- "name": "alessioarcara"
- },
- "plugins": [
- {
- "name": "pyrefly-lsp",
- "description": "Python language server (Pyrefly) for type checking and code intelligence",
- "version": "0.2.0",
- "source": "./plugins/pyrefly-lsp",
- "category": "development"
- }
- ]
- }
README.md · README · 48 lines
- # pyrefly-lsp
- A Claude Code plugin that runs [Pyrefly](https://pyrefly.org) as the language server for Python (`.py`, `.pyi`): hover, go to definition, find references, symbols, call hierarchy and diagnostics.
- [](https://github.com/alessioarcara/claude-pyrefly-lsp/actions/workflows/validate.yml)
- ## Requirements
- The plugin only tells Claude Code how to start the server; the `pyrefly` binary must be on your `PATH`:
- ```bash
- uv tool install pyrefly
- # or
- pip install pyrefly
- ```
- ## Installation
- ```bash
- claude plugin marketplace add alessioarcara/claude-pyrefly-lsp
- claude plugin install pyrefly-lsp@alessioarcara-plugins
- ```
- Then restart Claude Code or run `/reload-plugins`. If `pyrefly` is not on your `PATH`, the plugin says so when a session starts.
- If you have the official `pyright-lsp` plugin, disable it, so two servers do not both answer for the same files:
- ```bash
- claude plugin disable pyright-lsp@claude-plugins-official
- ```
- ## Type checking mode
- In a project with no `pyrefly.toml` (or `[tool.pyrefly]` in `pyproject.toml`), Pyrefly falls back to its `basic` preset, which does not infer the return type of functions without annotations: hover shows `-> Unknown`.
- This plugin starts the server with the `default` preset instead, so return types are inferred in every project without a config file. The price is more diagnostics than `basic` reports.
- The preset is an option of the plugin (`basic`, `legacy`, `default` or `strict`). To change it:
- ```bash
- echo '{"typeCheckingMode": "basic"}' | claude plugin configure pyrefly-lsp@alessioarcara-plugins --values-stdin
- ```
- The setting applies to the language server only. `pyrefly check` on the command line still follows the project's own config.
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.