プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説 ログイン

Spirolo

✓ ブランド名の GitHub · github.com/spirolo

作者:spiroloバージョン 0.1.0-alpha.2i★ 6iパソコンで動く公式サイト ↗
レジストリ名io.github.spirolo/spirolo

インストール方法

できること

Whole-project analyzer for JavaScript test suites

作者による原文

  • 接続方法 パソコンで動く
  • アカウントまたはキー キー不要
  • カテゴリ 開発者ツール

一緒に使える

この種の作業を AI に教える Skill。これと一緒に使えます

rea

Reverse engineer anything with agents, from app behavior down to native binaries.

作者:morluto★ 470,1651 個の skill

Skill · 手順書

andrej-karpathy-skills

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

作者:multica-ai★ 234,5281 個の skill

Skill · 手順書ライセンス記載なし

graphify

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

作者:Graphify-Labs★ 150,6951 個の skill

Skill · 手順書

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気10/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア22/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Spirolo をインストールして。https://mcp.popnx.com/i/spirolo.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月21日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server Spirolo を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "spirolo": { "command": "npx", "args": [ "-y", "spirolo", "mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Spirolo のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  3. この設定を貼り付けて保存

    {
      "mcpServers": {
        "spirolo": {
          "command": "npx",
          "args": [
            "-y",
            "spirolo",
            "mcp"
          ]
        }
      }
    }
  4. Claude を終了してもう一度開く

  5. 試してみる

    Spirolo を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Spirolo を使っていると言うか、回答に Spirolo のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Spirolo につなげません

Spirolo はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · Spirolo につなげるアプリを使う

  • 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • 先にパソコンへ Node.js を入れてください(1 回だけ)
  • 先にパソコンへ Node.js を入れてください(1 回だけ)
  • 先にパソコンへ Node.js を入れてください(1 回だけ)

B · 開発者ツール の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server Spirolo を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user spirolo -- npx -y spirolo mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Spirolo のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

    claude mcp add --scope user spirolo -- npx -y spirolo mcp
  4. Claude Code で /mcp と入力

    Spirolo が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    Spirolo を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Spirolo を使っていると言うか、回答に Spirolo のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server Spirolo を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "spirolo": { "command": "npx", "args": [ "-y", "spirolo", "mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Spirolo のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. Cursor の AI チャットを Agent モードで開く

  4. 試してみる

    Spirolo を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Spirolo を使っていると言うか、回答に Spirolo のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server Spirolo を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "spirolo": { "type": "stdio", "command": "npx", "args": [ "-y", "spirolo", "mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Spirolo のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. VS Code の AI チャットを Agent モードで開く

  4. 試してみる

    Spirolo を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Spirolo を使っていると言うか、回答に Spirolo のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?Spirolo を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user spirolo -- npx -y spirolo mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "spirolo": {
      "command": "npx",
      "args": [
        "-y",
        "spirolo",
        "mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "spirolo": {
      "command": "npx",
      "args": [
        "-y",
        "spirolo",
        "mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "spirolo": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "spirolo",
        "mcp"
      ]
    }
  }
}

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
17/週
接続方法
パソコンで動く
最新バージョンi
0.1.0-alpha.2
レジストリ公開日i
2026年11月21日
コードの最終更新i
2026年11月21日
作者
spirolo
パッケージ
npm: spirolo
ウェブサイト
spirolo.com
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月21日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント spirolo で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:今日

  • ✓ 合格

    ライセンスがある

    Apache-2.0を使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

OSV.dev に spirolo@0.1.0-alpha.2 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月21日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/spirolo.svg)](https://mcp.popnx.com/en/servers/spirolo)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

開発者ツールのほかのサーバーとの比較i

  • このカテゴリのほかの6686件のうち87%よりスターが多い
  • このカテゴリのほかの6686件のうち99%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの6686件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Spiroloは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は今日、最新バージョン(0.1.0-alpha.2)がレジストリに届いたのは今日です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは?

同じカテゴリには:GitDiagram, Appllama, Cloudflare MCP, Omnara, hotpath-cloud

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

GitDiagram

Architecture diagrams, explanations and Mermaid source for public GitHub repositories.

作者:ahmedkhaleel2004広く使われている★ 1.9万2 か月前更新

クラウドで動く✓ 提供元 · gitdiagram.comPopNx チームが実際に試用

Appllama

Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.

作者:Appllama広く使われている★ 53173 か月前更新

クラウドで動く✓ 提供元 · appllama.io

Omnara

Deploy durable AI agents with Omnara, an open-source managed-agent platform.

作者:omnara-ai広く使われている★ 34272 か月前更新

クラウドで動く✓ 提供元 · omnara.com

hotpath-cloud

Read-only access to Rust profiling reports from CI: benchmark history, diffs and policies

作者:hotpath-rs成長中★ 192812 日前更新

クラウドで動く✓ 提供元 · hotpath.rs
似たものと比べる
これ
Spirolo
GitDiagramAppllamaCloudflare MCPOmnarahotpath-cloud
動く場所パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要いいえいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえはいいいえいいえ
基本チェック3/34/44/44/44/44/4
ライセンスApache-2.0MITMITApache-2.0Apache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Spirolo

English | 简体中文

Spirolo is a static analyzer for JavaScript and TypeScript test suites.

It reads tests, source code and runner configuration together to find missing setup guards, untracked skips, duplicate tests and assertions that may pass without testing anything. Analysis runs locally in a Rust binary, without running your tests or sending your code anywhere.

What Spirolo will not do

  • It does not run your tests or execute your code.
  • It does not fix or rewrite your source files.
  • It does not fail CI by default: findings are advisory until you raise a rule's severity.
  • It does not send your code anywhere: analysis needs no network access.
  • It covers JavaScript and TypeScript test suites only.

Install

Node 20 or newer, from your project's root:

npm install -D spirolo@alpha

npx spirolo check

No Spirolo config is needed. Install your project's dependencies first so its TypeScript configuration and imports can resolve.

The npm launcher selects a native platform package for Linux or macOS (x64 and arm64), without a postinstall download.

To build from source instead, with the current stable Rust toolchain, from this repository's root:

cargo build --release --locked -p spirolo

./target/release/spirolo check /path/to/your/project

One real run

Captured from the release binary built at Spirolo commit 4a8d80cd, on Kaneo at commit afe97be2473e0cd97fe4a63e526fef9ac4df85b0, with its dependencies already installed. Set KANEO to the path of that checkout, then run from Spirolo's source directory:

./target/release/spirolo check "$KANEO"

Excerpt below: [...] marks omitted lines. The timing is from this run, not a benchmark.

1754 files · 351 test files · 1797 tests (1797 vitest) · 4309 expects · 0 handlers · 35 configs · 253ms

Health C (60) [...] ● fail-closed-setup (10 files, 19 findings) · advisory: 19/19 (UNADJUDICATED) apps/api/vitest.config.ts (2) :0 setup does not guard the console (no throwing console.error/warn spy or fail-on-console package) :0 setup does not restore mocks between tests (no restoreMocks or afterEach restoreAllMocks) [...] 34 findings in 3 of 16 rules · 0 warn · 0 error · 34 info · exit 0 hidden 1226 findings: 1211 experimental (gate-truth 11, unused-mock 3, flake-candidate 1, untested-hotspot 1196), 15 from DROPPED or FAIL rules (weak-assertion 15); spirolo check --all shows them note no churn input: untested-hotspot ranks by complexity × weakness alone. Save git log --numstat --format= --since=180.days to a file and pass it with --churn or name it in inputs.churn

This run reported missing setup guards, absence-only assertions and a possible duplicate. It did not execute Kaneo's tests or verify each finding. The command exited successfully because these findings are advisory. The hidden count includes experimental hotspot rankings without churn data; it is not a count of confirmed bugs.

What it finds

The default report shows these advisory rules:

RuleWhat to inspect
absence-anchorA test checks that something is absent without checking that the expected content rendered.
dead-skipA test is skipped without a linked issue, or focused so other tests will not run.
duplicate-testTest bodies and their modeled setup look equivalent. Check whether they cover different behavior before deleting either.
fail-closed-setupRunner setup lacks guards for mock cleanup, console errors or unhandled requests.

check --all also shows experimental rules and rules whose measurements failed or were dropped. These include merge-gate checks, static flake candidates, unused mocks and source modules ranked by churn, complexity and test strength. Use spirolo explain to read a rule's claim and measured status.

Why another test tool?

Test lint plugins check patterns in test code. Coverage reports tell you what ran. Mutation tools such as Stryker check whether tests detect changes to production code. Spirolo adds a view across tests, imports, setup and runner configuration, and can read existing coverage, mutation and run reports. Keep running your tests and using those tools: a static finding answers a different question.

The tooling comparison explains that division of work.

How far to trust it

No rule is proven yet. The measurements below record how often sampled findings were judged correct, not how many bugs Spirolo can find in your project.

  • Advisory: shown by default once a rule has at least 15 decided findings and measured precision of at least 0.80. These findings report at info.
  • Experimental: findings appear only with --all unless you opt the rule in. The evidence is too limited or the measured precision is below the advisory floor.
  • FAIL or DROPPED: findings appear only with --all and never gate, even with a severity override.
  • Proven: reserved for a rule that passes the measurement bar and a fresh held-out check. None has done so.

Today, findings do not fail a command by default. To make a rule gate, set its severity to warn or error in .spirolorc.jsonc, subject to the rule's allowed severities. For example:

{ "rules": { "dead-skip": { "severity": "warn" } } }

Rule tiers explains the thresholds, labels, exit codes and override limits. spirolo rule-status prints the measurements embedded in your binary.

Measured precision

This table is generated from the embedded measurement data, using public repositories only. A perfect result on a small sample is not proof; the confidence intervals show the uncertainty. These are measurements at the recorded commit, not a new evaluation of every later change. n/a means no findings were decided, so there is no precision estimate.

Measured at spirolo commit 939f0af519fd50318e092700b74094b71cfeca23 across 40 OSS dev entries. Advisory: at least 15 decided and shown precision at least 0.80.

RuleTierStatusTrue / decidedPrecision95% Wilson intervalMeasured entries
absence-anchoradvisoryUNADJUDICATED28 / 281.0000.879–1.00016
dead-skipadvisoryUNADJUDICATED39 / 391.0000.910–1.00021
duplicate-testadvisoryUNADJUDICATED15 / 180.8330.608–0.94219
fail-closed-setupadvisoryUNADJUDICATED19 / 191.0000.832–1.00010
flake-candidateexperimentalINSUFFICIENT3 / 60.5000.188–0.8127
gate-truthexperimentalUNADJUDICATED12 / 180.6670.437–0.8378
untested-hotspotexperimentalUNADJUDICATED5 / 160.3130.142–0.55640
unused-mockexperimentalINSUFFICIENT0 / 0n/an/a1
data-layer-mockhiddenDROPPED0 / 0n/an/a0
flake-observedhiddenFAIL39 / 520.7500.618–0.8484
generator-walkhiddenDROPPED0 / 0n/an/a0
handler-drifthiddenDROPPED0 / 0n/an/a0
orphan-testhiddenDROPPED4 / 140.2860.117–0.54612
redundant-testhiddenDROPPED0 / 120.0000.000–0.2435
stale-snapshothiddenDROPPED0 / 0n/an/a3
weak-assertionhiddenDROPPED12 / 340.3530.215–0.52117

Where it runs

The native package targets are Linux with glibc and macOS, on x64 and arm64. Windows and Alpine/musl are outside the alpha's targets. The native binary needs neither Node nor network access for analysis.

The measured scope is JavaScript and TypeScript React projects using Vitest or Jest. Spirolo also reads Playwright configuration and test patterns; this does not make every framework or configuration a measured target.

Use the CLI locally, Markdown summaries or GitHub annotations in CI, or MCP in an agent client. JSON and SARIF reports are available with --format json and --format sarif. A VS Code extension using the same binary can be packaged and installed locally.

Scope

Spirolo does not run tests, launch mutation engines, collect coverage, generate tests or host run history. It reads artifacts you already have. Missing artifacts are reported as unverified context, not as evidence that the suite works.

A static flake candidate is not an observed flaky test. A duplicate finding is a reason to inspect the tests, not permission to delete them. The provisional health score is a summary of signals, not a guarantee of correctness.

Vue, Cypress, other languages and arbitrary non-React frameworks are outside the measured scope.

Status and limits

Version `0.1.0-alpha.2`: advisory alpha. It is on npm as spirolo@alpha; the VS Code extension is not published yet. Before 1.0, any alpha may change commands, output and rule behaviour; the changelog lists every change.

Static analysis can miss dynamic configuration and patterns it does not model. If a TypeScript configuration cannot load, Spirolo reports module-resolution problems and marks affected findings as unreliable. Install missing dependencies and resolve the configuration warning before relying on those rows.

The human report caps displayed files and findings. spirolo check --rule --all shows the full report for that rule, including experimental or dropped findings. Review the evidence before opting a rule into CI.

Contributions are welcome: see CONTRIBUTING.md. For vulnerability reports, see SECURITY.md.

Licence

Apache 2.0.