pyfltr 3.4.1

Python Formatters, Linters, and Testers Runner.

pyfltr: Python Formatters, Linters, and Testers Runner

Python / Rust / .NET / TypeScript・JavaScript / ドキュメントなど多言語プロジェクトの formatter・linter・testerを単一コマンドで並列実行するCLIツール。 （要Python 3.11以上）

特徴

• formatter・linter・testerをまとめて呼び出す
• 複数ツールの並列実行による総実行時間の短縮
• コーディングエージェント向けJSON Lines出力（--output-format=jsonl）
• 設定の集約: pyproject.tomlに寄せた統一設定
• 除外指定（exclude）の書式差をツール間で吸収
• MCPサーバー（pyfltr mcp）
• シェル補完スクリプト生成

インストール

pip install pyfltr
# uv を使う場合
uv add --dev pyfltr

uvxでの実行も可能。

uvx pyfltr --help

Python系ツール（ruff / mypy / pylint / pyright / ty / pytest / uv-sort）を利用する場合は、extrasで追加依存を導入する。

pip install 'pyfltr[python]'

Python / JavaScript / Rust / .NETの各言語カテゴリに属するツールはすべて既定で無効（opt-in）である。 preset = "latest" + 言語カテゴリキー（python / javascript / rust / dotnet）のtrue指定だけで、 当該言語の推奨ツール一式が有効化される。 プリセット非収録のツール（tyなど）を追加したい場合のみ個別に{command} = trueを指定する。 詳細は設定項目を参照。

コーディングエージェント向け運用

コーディングエージェントから利用する経路は2種類ある。

直接呼び出し（シェルコマンドが実行できる環境）:

# JSONL形式で全チェックを実行し、結果をエージェントが読み込む
uvx pyfltr run-for-agent

# 直前runで失敗したツール・ファイルだけ再実行
uvx pyfltr run-for-agent --only-failed

run-for-agentはpyfltr run --output-format=jsonlのエイリアス。 JSONL出力の末尾summary行で全体像を把握でき、必要に応じてdiagnostic行を参照することでトークン消費を抑えられる。

MCP経由（コーディングエージェントのMCPクライアント経由）:

# コーディングエージェントへの登録例（コマンド形式）
claude mcp add pyfltr -- uvx pyfltr mcp

または設定ファイルに直接記載する方法:

{
  "mcpServers": {
    "pyfltr": {
      "command": "uvx",
      "args": ["pyfltr", "mcp"]
    }
  }
}

MCPツールrun_for_agentでpaths・commands・fail_fastを指定して実行できる。

ドキュメント

• https://ak110.github.io/pyfltr/ — 概要・対応ツール一覧・設定リファレンス
• https://ak110.github.io/pyfltr/llms.txt — LLM向け構造化インデックス
• docs/development/development.md — 開発者向け情報