why-is-this-slow — コマンド実行の遅延解析CLI

ToolGoCLIパフォーマンス

barthollomew/why-is-this-slow

GitHub で見る

GitHub →

概要

why-is-this-slow は、任意のコマンドを実行してその実行時間とリソース使用に関する「事実」を記録し、後から説明（explain）や比較（compare）できるように保存する軽量なGo製CLIです。繰り返し実行して中央値などの安定指標を取るリピートモード、子プロセスのCPU時間（user+sys）や最大RSS（rusageが利用可能な環境で）を取得する機能を持ちます。収集した各ランはOSに合わせた状態ディレクトリに保存され、後で履歴を参照して原因候補を絞ったり、パフォーマンスの回帰を検出したりする用途に適しています。プロファイラやトレーサとは異なり、関数単位やシステムコール単位の詳細な内訳は提供しませんが、手軽に状況を把握する「軽量計測器」として有用です。

GitHub

リポジトリの統計情報

  • スター数: 4
  • フォーク数: 3
  • ウォッチャー数: 4
  • コミット数: 4
  • ファイル数: 5
  • メインの言語: Go

主な特徴

  • 任意コマンドを実行して壁時計時間・子プロセスCPU時間・最大RSSなどを取得して記録
  • リピートモードで複数回実行し、安定した中央値などの指標を算出
  • 実行ごとの結果をOS適切な状態ディレクトリに保存し、後で explain / compare が可能
  • プロファイラではなく軽量な計測ツールとして設計（詳細な関数単位解析は行わない）

技術的なポイント

why-is-this-slow は小さくシンプルなGo製CLIとして設計されており、実行のオーケストレーション、統計集計、永続化に注力しています。コマンドの起動には標準ライブラリを用い、プロセスの開始から終了までの壁時計（実時間）を計測する一方、利用可能なプラットフォームでは rusage を利用して子プロセスの CPU 時間（ユーザ時間 + システム時間）と最大RSS（resident set size）を取得します。これにより、単純な経過時間だけでなく CPU バウンドかメモリ消費が原因か、といった切り分けに役立つ指標を得られます。

繰り返し実行する「リピートモード」は、単発実行のばらつきを排除するための実用的な工夫です。複数回のランから中央値などの代表値を採ることでノイズを減らし、安定した比較基準を提供します。各実行結果はコマンド文字列、引数、タイムスタンプ、計測値（wall, cpu,user+sys, maxrss など）を含むメタ情報として OS に適した状態ディレクトリ（例: XDG ベースやプラットフォーム固有ディレクトリ）に保存され、後から explain（単一実行の説明）や compare（複数実行の差分比較）が可能です。

設計上のトレードオフとして、why-is-this-slow はプロファイラやトレーサのように関数単位・システムコール単位での内訳を提供しません。深掘りが必要な場合は perf、strace、dtrace 等のツールと組み合わせることが推奨されています。コードベースが小さい点（ファイル数が少ない）や internal パッケージの構成から、導入や拡張がしやすく、CI 内での回帰検出や日常のコマンド比較用途に向いています。

プロジェクトの構成

主要なファイルとディレクトリ：

  • .github: dir
  • .gitignore: file
  • README.md: file
  • go.mod: file
  • internal: dir

まとめ

手軽にコマンドの遅延原因候補を記録・比較できる、小さく実用的な計測CLI。

リポジトリ情報：

READMEの抜粋：

Why is this slow?

A small Go CLI that runs a command, records timing and resource facts, and keeps them so you can explain or compare later.

Details

  • What it is: lightweight timer with repeat mode for stable medians; captures child CPU (user+sys) time and max RSS via rusage when supported; stores every run under an OS-appropriate state directory for later explain and compare.
  • What it is not: a profiler or tracer; it will not pinpoint specific functions or syscalls. Use perf, strace, or…

関連記事

Tool

acli — 統合Androidコマンドラインツール

Android開発で使う複数のコマンドラインツール（sdkmanager, avdmanager, adb, fastboot, Gradle 等）を単一の使いやすい CLI に統合するツールです。パッケージパスや各ツール固有のフラグを覚える必要を減らし、開発者のローカル環境と CI 両方で一貫した操作性を提供します。Go 言語で実装され、CI ワークフローやライセンス情報が含まれています。導入することで、設定確認（doctor）や AVD 操作、パッケージ管理、デバイス操作などを短いコマンドで扱えるようになります。

AndroidCLIGo
Tool

repo-clean：リポジトリ肥大化診断のためのミニマルCLI

repo-cleanは、リポジトリ内の肥大化原因を素早く可視化するための最小限のCLIツールです。大きすぎるファイル、ハッシュによる重複ファイル、一般的なジャンクディレクトリ（ビルド成果物やキャッシュ等）を検出して、端末向けの見やすい出力とCIで扱いやすいJSON出力を提供します。Go製の軽量ツールで、CIパイプラインやローカルチェックに組み込みやすく設計されています。

GoCLIRepoメンテナンス
Tool

metcli — Meta（旧Facebook）からデータを抽出するCLI

metcliは、Meta（Facebook / Instagramなど）からユーザーデータを取り出すことを目的としたコマンドラインツールです。現状は非常にWIP（Work In Progress）ですが、Goで書かれた軽量なCLI実装で、API呼び出しやデータ取得、ローカルへの保存といった基本的なワークフローを想定しています。拡張性を意識したコマンド構成やMakefileによるビルド自動化が用意されており、自分用のデータ抽出ツールを素早く試作したい開発者向けのスケルトンプロジェクトです。（約300字）

CLIMetaGo
Tool

gmn — 軽量な非対話型 Gemini CLI（Go製）

Google の Gemini CLI にインスパイアされた、Goで実装された軽量な非対話型（non-interactive）Gemini CLI。単発のプロンプト送信を想定したシンプルなコマンドラインツールで、Makefile や goreleaser を含む CI/CD 設定によりクロスビルド／リリースが容易に行える設計になっています。（300字程度）

GoCLIGemini
Tool

cc-trading — 極簡取引ログ解析CLI

cc-tradingは、Goで書かれた軽量なコマンドラインツールです。交互式のプロンプトで開・平倉操作を記録し、JSONL形式で永続化します。複数アカウント対応、強制的なリスク管理（必須の損切・利確設定）、未決済ポジションの一括管理、柔軟なフィルタ検索、リアルな損益と証拠金ROIの二重指標表示など、トレードログの記録と分析に特化。さらにAnthropicのClaude Codeを使った自動リスク評価・パフォーマンス分析機能を備え、単一の実行ファイルとしてクロスプラットフォームで動作します（Windows/Mac/Linux）。300字程度の簡潔な説明です。

tradingcliGo
Tool

unegg — .eggアーカイブ抽出ツール

uneggは、.egg形式のアーカイブからファイルを抽出するシンプルかつ高速なコマンドラインツールです。Goで実装されており、並列ワーカーを使った高速な展開、パスワード保護されたアーカイブの復号、一覧表示モード、Homebrewからのインストール対応などを備えます。軽量で依存が少なく、単一バイナリで配布できる設計になっているため、ローカルやCI環境でのバッチ処理にも適しています。（約300字）

GoCLIArchive