Hindsight — ターミナル向け Git 活動ビジュアライザ

Tool

概要

Hindsight は、ローカルのディレクトリを再帰的に走査して Git レポジトリを検出し、各リポジトリのコミット履歴を集計してターミナル上に GitHub スタイルのヒートマップを描画するツールです。色は青系で統一された「ピクセル風」表示を採用し、週単位・日単位の貢献状況を一目で把握できます。コマンドラインから動作し、Rust 製のため高速かつコンパクトで、cargo でインストール可能。視覚的に貢献履歴を確認したい開発者や、GUI を使わずに端末で完結したい場面に向きます。

GitHub

リポジトリの統計情報

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

主な特徴

  • GitHub スタイルの貢献ヒートマップをターミナルで表示
  • ローカルディレクトリを走査して複数リポジトリを横断集計
  • Rust 製で cargo install による簡単インストール
  • 軽量・シンプルなコードベースで拡張が容易

技術的なポイント

Hindsight は Rust を採用しており、パフォーマンスとメモリ安全性を活かしてローカルファイルシステムの再帰走査や Git 履歴の解析を行います。実装の核心は「コミット日時の収集」「日別カウントへの集約」「グリッドへのマッピング」「ターミナルへの描画」の4段階です。まず対象ディレクトリ内の .git を持つディレクトリを検出し、それぞれのリポジトリからコミットログ(日時、著者など)を取得します。ログの取得は外部 git コマンドを呼び出す方法か、libgit2 相当のライブラリ経由のどちらかで実装でき、いずれも日付パースとタイムゾーン処理が重要です。取得した日時は日付単位に丸めてカウントし、週ごと・曜日ごとのマトリクスに配置します。

表示部分では、ANSI カラーコードや Unicode ブロック文字を用いて色付きセルを描画することで、端末上にピクセル風ヒートマップを実現します。色の段階(強度)はコミット数の相対値に応じて青系の階調を割り当て、視認性を保ちながら貢献度の違いを示します。小規模なコードベース(ファイル数が少ない)であるため、拡張やテーマ変更(色やサイズ)を加えやすく、並列化して複数リポジトリを同時に処理する実装も取り入れやすい構造です。クロスプラットフォームでは、端末のカラーサポートや改行コードの違いに配慮する必要がありますが、Rust でのビルドと cargo install により導入は容易です。

プロジェクトの構成

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

  • .gitignore: file
  • Cargo.lock: file
  • Cargo.toml: file
  • README.md: file
  • src: dir

まとめ

端末上で手軽に GitHub 風の貢献ヒートマップを確認できる、シンプルで実用的な Rust 製ツール。

リポジトリ情報:

READMEの抜粋:

Hindsight

Hindsight is a GitHub-style git activity visualizer for your terminal. It scans your local directories for git repositories and aggregates your contribution history into a beautiful, blue, pixel-perfect heatmap.

image

Installation

cargo install hindsight

You can get cargo [here](https://doc.rust-lang.org/cargo/getting-started/insta