Ganger

🚀 ギャンガー - GitHubレンジャー

GitHubでスターを付けたリポジトリを管理するためのターミナルベースのファイルマネージャーです。rangerにインスパイアされており、vimのキーバインドとマルチペインインターフェースを使って、GitHubのスターをナビゲート、整理、管理できます。

🚀 クイックスタート

認証

ギャンガーは2つの認証方法をサポートしています。

1. OAuthデバイスフロー (推奨):

   ganger auth
   # ブラウザを通じて認証するための指示に従ってください
   

2. パーソナルアクセストークン:

   export GITHUB_TOKEN=your_token_here
   ganger tui
   

MCPサーバー

MCPサーバーを使用すると、LLMエージェントがGitHubのスター管理を調整できます:

# MCPサーバーを起動
ganger mcp

# サーバーは以下のようなツールを公開しています:
# - list_starred_repos
# - create_virtual_folder
# - move_repo_to_folder
# - star_repository
# - get_repo_details

✨ 主な機能

• デュアルインターフェース: TUI (Textual) と MCP (Model Context Protocol) サーバー
• ミラーカラム: 3列のrangerスタイルのビュー (フォルダ | リポジトリ | プレビュー)
• 仮想フォルダ: タグベースの仮想フォルダを使ってスターを整理
• 自動分類: 言語、トピック、アクティビティに基づいてリポジトリを自動的に分類
• Vimキーバインド: hjklでのナビゲート、ビジュアルモード、切り取り/コピー/貼り付け
• スマートキャッシュ: オフラインブラウジングとAPI呼び出しの削減のためのSQLiteキャッシュ
• デュアル認証: OAuthデバイスフローまたはパーソナルアクセストークン

📦 インストール

前提条件

• Python 3.10以上
• Poetry (依存関係管理用)
• GitHubアカウント

Poetryでインストール

# リポジトリをクローン
git clone https://github.com/synapticsage/ganger.git
cd ganger

# 依存関係をインストール
poetry install

# 仮想環境をアクティブ化
poetry shell

# 認証セットアップを実行
ganger auth

# TUIを起動
ganger tui

# またはMCPサーバーを起動
ganger mcp

📚 ドキュメント

設定

設定ファイル: ~/.config/ganger/config.yaml

デフォルト設定と利用可能なオプションについては、config/config.yaml を参照してください。

プロジェクトの状態

フェーズ1 (進行中): コア基盤

• [x] プロジェクト構造と依存関係
• [ ] コアデータモデル
• [ ] GitHub認証 (OAuth + PAT)
• [ ] GitHub APIクライアント (REST + GraphQL)
• [ ] SQLiteキャッシュ
• [ ] 自動分類機能付きフォルダマネージャー
• [ ] MCPサーバー
• [ ] 設定システム
• [ ] 単体テスト

フェーズ2 (計画中): TUIインターフェース フェーズ3 (計画中): 高度な機能

アーキテクチャ

ギャンガーは、TUIとMCPの両方のインターフェースが利用するクリーンなサービスレイヤーアーキテクチャを採用しています:

ganger/
├── core/          # ビジネスロジック (共有)
│   ├── models.py
│   ├── github_client.py
│   ├── cache.py
│   ├── auth.py
│   └── folder_manager.py
├── mcp/           # MCPサーバーインターフェース
│   ├── server.py
│   └── tools.py
└── tui/           # TUIインターフェース (フェーズ2)
    └── app.py

開発

テストの実行

poetry run pytest

コード品質

# コードをフォーマット
poetry run black src/ tests/

# リント
poetry run ruff check src/ tests/

# 型チェック
poetry run mypy src/

📄 ライセンス

MIT

クレジット

• ファイルマネージャー ranger にインスパイアされました
• アーキテクチャパターンは yanger から借りています
• Textual と MCP を使用して構築されています