Skip to content
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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/alessioarcara--claude-pyrefly-lsp/badge.svg)](/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
  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "alessioarcara-plugins",
  4. "description": "Pyrefly language server plugin for Claude Code",
  5. "owner": {
  6. "name": "alessioarcara"
  7. },
  8. "plugins": [
  9. {
  10. "name": "pyrefly-lsp",
  11. "description": "Python language server (Pyrefly) for type checking and code intelligence",
  12. "version": "0.2.0",
  13. "source": "./plugins/pyrefly-lsp",
  14. "category": "development"
  15. }
  16. ]
  17. }
README.md · README · 48 lines
  1. # pyrefly-lsp
  2. 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.
  3. [![validate](https://github.com/alessioarcara/claude-pyrefly-lsp/actions/workflows/validate.yml/badge.svg)](https://github.com/alessioarcara/claude-pyrefly-lsp/actions/workflows/validate.yml)
  4. ## Requirements
  5. The plugin only tells Claude Code how to start the server; the `pyrefly` binary must be on your `PATH`:
  6. ```bash
  7. uv tool install pyrefly
  8. # or
  9. pip install pyrefly
  10. ```
  11. ## Installation
  12. ```bash
  13. claude plugin marketplace add alessioarcara/claude-pyrefly-lsp
  14. claude plugin install pyrefly-lsp@alessioarcara-plugins
  15. ```
  16. Then restart Claude Code or run `/reload-plugins`. If `pyrefly` is not on your `PATH`, the plugin says so when a session starts.
  17. If you have the official `pyright-lsp` plugin, disable it, so two servers do not both answer for the same files:
  18. ```bash
  19. claude plugin disable pyright-lsp@claude-plugins-official
  20. ```
  21. ## Type checking mode
  22. 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`.
  23. 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.
  24. The preset is an option of the plugin (`basic`, `legacy`, `default` or `strict`). To change it:
  25. ```bash
  26. echo '{"typeCheckingMode": "basic"}' | claude plugin configure pyrefly-lsp@alessioarcara-plugins --values-stdin
  27. ```
  28. The setting applies to the language server only. `pyrefly check` on the command line still follows the project's own config.
  29. ## License
  30. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.