Ghostty Blackhole とは？ターミナルに降り臨むブラックホールシェーダー【Claude Code連携】

Ghostty Blackhole は GLSL シェーダーでターミナル内にブラックホールを描写するオープンソースツールです。Claude Code のコンテキスト使用率をリアルタイムで可視化するトークンモードや、ポモドーロタイマー連動モードを搭載。物理ベースのシュワルツシルト計量レンダリングで本格的な重力レンズ効果を再現します。

GitHubで急上昇中の s0xDk/ghostty-blackhole をご紹介します。 スター数 1007★ を獲得し、DevTool分野で注目されているツールです。

---

s0xDk/ghostty-blackhole とは？

Ghostty Blackhole は、Ghostty ターミナル上で本格的なブラックホールアニメーションを表示するオープンソース GLSL シェーダープロジェクトです。単なる視覚効果にとどまらず、Claude Code のコンテキストウィンドウ使用率をリアルタイムでブラックホールのサイズに反映する「トークンモード」が最大の特徴です。シュワルツシルト計量に基づく物理的に正確な光線追跡・重力レンズ・降着円盤の描写を行い、macOS 向けの SwiftUI チューナーアプリも同梱しています。

こんな人におすすめ:

• エンジニア向け: Claude Code を日常使いする開発者や Ghostty ユーザー向け。コンテキスト上限の視覚的把握・ポモドーロ管理ツールとして実用的に使えます。
• 非エンジニア向け: プログラミング知識が必要なため、エンジニア専用ツールです

---

主な機能・特徴

• Claude Codeのコンテキスト使用率をリアルタイムでブラックホールサイズに反映するトークンモード
• シュワルツシルト計量による物理ベースの重力レンズ・降着円盤・光子リングを描写
• 55分作業+5分休憩サイクルを自動管理する自己完結型ポモドーロモード
• macOS 向け SwiftUI チューナーアプリ（Gargantua・Quasar 等のプリセット搭載）
• タイピング検知による自動フェードイン/アウト・複数 Ghostty ウィンドウでの独立動作

---

使い方・始め方

Ghostty 1.3 以上が必要です。

# リポジトリをクローン
git clone https://github.com/s0xDk/ghostty-blackhole.git

Ghostty config（~/.config/ghostty/config）に追記:

custom-shader = /path/to/blackhole_ghostty/blackhole.glsl
custom-shader-animation = true

トークンモードのセットアップ（~/.claude/settings.json）:

{
  "statusLine": {
    "type": "command",
    "command": "/path/to/blackhole_ghostty/claude-token.py"
  },
  "hooks": {
    "SessionStart": [{ "hooks": [{ "type": "command", "command": "/path/to/blackhole_ghostty/claude-token.py" }] }],
    "SessionEnd":   [{ "hooks": [{ "type": "command", "command": "/path/to/blackhole_ghostty/claude-token.py" }] }]
  }
}

設定後に Ghostty を再読み込み（cmd+shift+,）すると、Claude Code セッション起動と同時にブラックホールが現れます。

---

活用事例

活用例1: Claude Code を使うエンジニアがコンテキスト残量をひと目で把握し、/compact タイミングを直感的に判断

活用例2: ソフトウェア開発者がポモドーロタイマー代わりにブラックホールの成長で集中時間を管理

---

関連ツール・おすすめサービス

• DigitalOcean — 開発者向けクラウド・App Platformでかんたんデプロイ
• さくらVPS — 国内ホスティングでのセルフホストならこちら

---

まとめ

Ghostty Blackhole はエンジニアの日常開発環境に「美しさと実用性」を同時にもたらす稀有なツールです。物理シミュレーションベースのビジュアルエフェクトと Claude Code 連携という独創的な組み合わせが、1000 スターを超える人気の理由です。Ghostty ユーザーや Claude Code 愛用者はぜひ試してみてください。

GitHub でチェックする →

---

この技術を学ぶ

DevTool・GLSL シェーダーに興味を持った方には、Udemyのオンラインコースもおすすめです。

• 🎓 関連するDevTool・グラフィックスコース一覧 — セール時（最大90%OFF）を狙うとお得です