Live Git: ローカルのClaude Code(AIエージェント)がリモートGPUサーバーを直接扱えるようにするリモート開発CLIツール
(iamtaehyunpark.github.io)リモートGPUサーバーや研究室のマシンで作業するときに感じる慢性的な痛みを解決するために作った、Goベースの単一バイナリのリモート開発CLIツール、Live Git(lg)をオープンソースとして公開します。
Live Gitは、大規模なGPUサーバーのリソースがまるで自分のMacBookに接続されているかのような体験を実現できるよう支援します。
既存のVS Code Remote(IDE依存でローカルAIエージェントからアクセスできない)、rsyncループ(大規模リポジトリでは遅く手動管理が必要)、あるいは単純なSSH Multiplexingの限界を、FUSEベースのLazy LoadingマウントとキャッシュされたSSHトンネリングを組み合わせることで解決しました。
主な機能と特徴
-
Command Remoting(
lg <cmd>): ローカルでコマンドを打つと、キャッシュされたSSHセッションを通じてリモートGPU上で即座に実行され、カラー出力、プログレスバー、Ctrl+C、Exit Codeがローカルターミナルへリアルタイムにストリーミングされます。(Duo/2FA認証はlg connectで1日に1回だけ行えば、10時間トンネリングが維持されます。) -
File Browsing(
lg shell): FUSEベースでリモートリポジトリをローカルにマウントします(macFUSEのインストールが必要)。100GBを超える大規模リポジトリでもメタデータを即座に読み込み、ローカルEditor(ネイティブのファイルエクスプローラー、VS Code、Vimなど)ですぐに開けます。ファイルは開いたときにLazy Loadingされ、変更内容はジャーナリングシステムを通じてリアルタイムに同期されます。 -
Detached Jobs(
lg run -d): ノートPCのスリープやネットワーク切断に関係なく、リモートサーバー上で3日間にわたるモデル学習をバックグラウンドで安全に実行し、後からlg logs -f <id>でいつでも出力を追って見ることができます。 -
AI Agent-Native: このツールを作った本当の理由
最近ではClaude CodeやCodexのようなAIコーディングエージェントを活用する開発者が増えていますが、既存のツールではエージェントがリモートGPUインフラを直接ドライブするのが困難でした。
lg initで初回実行すると、プロジェクトルートにエージェント向けの手引きであるAGENTS.md(CLAUDE.md、人間向けのGUIDE.mdを含む)が自動生成されます。エージェントはこのガイドを読んで「ノートPCとリモートサーバー間の環境分離」を完全に理解し、リモートサーバー上のファイルを安全に修正し、GPU環境で直接テスト/学習コマンドを実行し、自律的にイテレーションを回せるようになります。実際の使用体験として驚くべきなのは、AIエージェントがlgを非常にうまく扱うことです。lgを通じて、エージェントたちはまるでサーバーサイドで動作しているかのように自然にサーバーリソースを活用します。コード修正はマウントされたローカルファイル上で直接行われたり、大きなファイルはコマンドを通じてサーバー上で直接修正したり、一部の小さなPythonコードはローカルデバイスで実行したりと、状況に応じて自在にlgを使いこなせるようになります。
インストールと始め方
依存関係やコンパイラのインストールは不要で、単一の静的バイナリとして動作します。
GitHubリポジトリに記載されている通りHomebrew tapでインストールした後、ターミナルでlgコマンドを実行すれば使えます。
初期設定は空のディレクトリでlg initコマンドを入力し、ターミナルの指示に従ってサーバーアドレスなどを入力すればすぐに利用できます。
まだコメントはありません。