JA Home - aku11i/phantom GitHub Wiki

Phantom Wiki

日本語 | English

技術概要

Phantomは、開発者に優しいエレガントなインターフェースを持つ、Git worktreeを管理するための強力なCLIツールです。TypeScriptとモダンなNode.jsで構築されており、並行開発のための効率的なワークフローを提供し、複数の機能、バグ修正、コードレビューを同時に作業することを容易にします。

主な技術的特徴

  • 最小限のランタイム依存関係 - コアパッケージは依存関係ゼロ、統合パッケージは必要最小限の依存関係のみ
  • TypeScript - モダンなESモジュールによる型安全なコードベース
  • Monorepoアーキテクチャ - より良い保守性のためのモジュラーパッケージ
  • AI統合 - AIアシスタント向けMCP（Model Context Protocol）サポート
  • GitHub統合 - PRやissueの直接チェックアウト
  • 設定サポート - phantom.config.jsonによるカスタマイズ
  • クリーンアーキテクチャ - CLI、Core、Gitレイヤーの関心の分離
  • 包括的なテスト - ネイティブNode.jsテストランナーによるユニットテスト
  • モダンなツール - 高速ビルドのためのesbuild、コード品質のためのBiome

ドキュメント

🚀 はじめに

はじめに - インストールから高度な使用法まで完全ガイド

  • インストールとセットアップ
  • コアコンセプトと用語
  • 基本コマンドとワークフロー
  • 実世界での例
  • 貢献者向け開発環境セットアップ

⚙️ 設定

設定 - phantom.config.jsonでphantomの動作をカスタマイズ

  • Worktreeディレクトリ設定
  • 自動ファイルコピー
  • 作成後・削除前フック
  • プロジェクト固有ワークフロー

🐙 GitHub統合

GitHub統合 - GitHub PRとissueとのシームレスな連携

  • 直接PR/issueチェックアウト
  • GitHub CLI統合
  • レビューワークフロー
  • チームコラボレーション

🤖 AI統合

AI統合 - AIアシスタントで開発を強化

  • MCP（Model Context Protocol）セットアップ
  • Claude DesktopとCursor統合
  • AI支援phantom管理
  • 自動化された開発ワークフロー

🏗️ アーキテクチャ

アーキテクチャ - 技術概要と設計原則

  • 技術スタックと依存関係
  • Monorepo構造（7パッケージ）
  • モジュール関係
  • パフォーマンス特性

開発者リソース

技術要件

  • Node.js: v22.0.0以上
  • パッケージマネージャー: pnpm（推奨）またはnpm
  • Git: worktreeサポートを持つモダンバージョン

クイックコマンドリファレンス

# グローバルインストール
npm install -g @aku11i/phantom

# 新しいphantom（worktree）を作成
phantom create <name> [branch]

# 既存ブランチにアタッチ
phantom attach <name> <branch>

# すべてのphantomをリスト
phantom list

# phantom内でコマンドを実行
phantom exec <name> <command>

# phantomシェルに入る
phantom shell <name>

# phantomを削除
phantom delete <name>

# GitHub統合
phantom github checkout <pr-or-issue-number>  # PR/issueをチェックアウト

# MCPサーバー管理
phantom mcp start  # AIアシスタント用MCPサーバーを起動

詳細なドキュメントについては、上記のセクションを探索するか、はじめにガイドをご覧ください。

⚠️ **GitHub.com Fallback** ⚠️