HN 日本語サマリー

← 一覧へ戻る
プログラミング

Oak: エージェントのためのGit

Oak: Git for Agents (oak.space)

20 pointsby handfuloflight12 コメント

要約

Oakは、AIコーディングエージェント向けに設計された新しいバージョン管理システム(VCS)です。従来のGitがリポジトリ全体をクローンする必要があるのに対し、Oakはファイルストリーミングやチャンク化されたデータ転送により、大規模リポジトリや大ファイルの扱いや、多数のブランチでの作業を高速化します。コミットメッセージの負担を減らし、エージェントのワークフローに最適化されています。コードのプライバシーも重視し、ユーザーのコードでモデルをトレーニングすることはありません。

全文翻訳

エージェントの基盤

Oakは、人間とエージェントが協力して作業するために構築されたバージョン管理システムです。

エージェントが作業する上でGitが最も速い方法である可能性はどれくらいでしょうか?私たちはそうは思わないので、何かを構築しています。私たちのベンチマークでは、スナップショットとステータスチェックはGitよりも最大95%高速に実行されます。モデルやIDEを変更する必要はありません。エージェントにOakを使用するように指示するだけです。

curl -fsSL oak.space/install | sh

その後、oak login oak init · 開始する · ソースはoak.space/oak/oakにあります。

Gitは素晴らしいですが、エージェントのために作られたものではありません。

Gitは素晴らしいと思いますが、完璧ではありません。独自のバージョン管理を構築することで、Gitの周りを回るのではなく、エージェントのワークフローを直接修正できます。

01

クローンではなくマウント。

oak mountは、リポジトリをクローンせずに作業ツリーを提供します。最初にファイルリストをダウンロードし、何かがそれを読み取ったときに各ファイルをフェッチします。各タスクは独自のブランチに独自の Маунт を取得し、oak spaceはタスクが触れるすべてのリポジトリのマウントを保持します。

Gitでは、まず完全な履歴をクローンしてから、タスクごとにworktreeを追加します。これは大きなリポジトリでは数分かかります。すべてのworktreeは1つの.gitを共有しており、それが破損すると、すべてのタスクが停止します。

oak mount acme/app ./fix-auth fix-auth--mount

src/auth/login.rs4.1Klocal
src/auth/session.rs6.8Klazy
src/main.rs2.0Klocal
api/12 fileslazy
Cargo.lock186Klazy

02

メッセージを書かずにコミット。

ブランチ上のコミットにはメッセージは必要ないため、エージェントは好きなだけ頻繁にチェックポイントを作成できます。ブランチの説明を1つ書き、oak mergeはそれをmainにコミットされる単一のsquashコミットのメッセージとして使用します。Oakはmainへの直接プッシュを拒否するため、設定ミスをしたエージェントが誤ってプッシュすることはありません。

Gitはすべてのコミットにメッセージを要求しますが、これはほとんどの場合、「wip」や「fix」でいっぱいの履歴になり、それらを書き込むためのトークンが無駄になります。

$ oak switch -c feat/oauth
$ oak commit # チェックポイント、メッセージなし
$ oak commit
$ oak desc "Replace REST auth with OAuth + PKCE"
$ oak merge # mainへの単一のsquash

03

LFSなしで大規模ファイルが動作します。

Oakはファイルをコンテンツ定義されたチャンクに分割し、各チャンクを1回だけ保存します。4 GBのチェックポイントの1つのテンソルを変更して再度プッシュした場合、変更されたチャンクのみがアップロードされます。

GitはこのためにLFSを必要としますが、それには独自のクォータとセットアップがあり、一部が変更されたときにファイル全体を再アップロードします。

私たちのベンチマークでは、マルチGBバイナリを持つタスクのスナップショットは、Oakでは321ミリ秒、Gitでは5,218ミリ秒かかります。

$ oak commit --push # 4 GB チェックポイント
$ oak commit --push # 編集後、変更されたチャンクのみをアップロード

ファイルの内容を確認できます。

エージェントは、コードと同様に、メッシュ、テクスチャ、オーディオ、モデルウェイト、データセットをコミットしますが、誰かがそれらを確認する必要があります。Oakのファイルビューは、ブラウザで231種類のフォーマットをプレビューします。以下のすべては、リポジトリのファイルビューと同じコードでレンダリングされた実際のファイルです。ぜひ触ってみてください。

acme/game main ドラッグして回転

プレビューするファイルを選択してください。

私たちを困らせてみてください。ファイル拡張子を入力してください。

3D 19
ゲームエンジン 16
画像 42
オーディオ&ビデオ 29
MLモデル 10
データ&サイエンス 33
マップ&点群 13
ドキュメント 23
アーカイブ&ディスクイメージ 27
その他 19

Git対Oak。

同じベンチマークハーネスで、同一のリポジトリに対して測定された中央値p50レイテンシ。自分でoak.space/oak/benchmarksで実行してください。何か問題が見つかった場合は、お知らせください。

Gitは、50kファイルでのコールドリポジトリ初期化(14.8ミリ秒対42.6ミリ秒)とプロセス起動(22.3ミリ秒対54.2ミリ秒)では依然として高速です。これらは小さな固定コストです。長いエージェントセッションでは、スナップショットとステータスチェックがさらに積み重なります。

GitHubが解決できない問題を解決します。

GitHubは、イシュー、GitHubスタイルのコードレビュー、10年の歴史を持つエコシステムなど、数え切れないほどのことを行います。しかし、GitとGitHubは、エージェントのために決して構築されなかったモデルを共有しています。

エージェントワークフロー向けOakGitHub + Git
最初の作業ツリー✓ 遅延マウント; フルクローンなし~ フルクローンを事前に実行; 大きなリポジトリでは数分
1つのリポジトリでの並列タスク✓ タスクごとのマウント、それぞれが独自のブランチ~ Git worktree; 1つの共有された壊れやすい .git
コミット✓ メッセージなしのチェックポイント; 説明がsquashメッセージになる· すべてのコミットにメッセージが必要
大規模ファイル✓ ネイティブ; fastcdcがバージョン間で重複排除~ LFS経由、別クォータ、追加設定
スナップショット速度⚡ 最大95%低いp50~ ツリー全体を再ハッシュ; 大きなリポジトリでは数秒
CI✓ 独自のランナーでのActionsスタイルのワークフロー; マージをゲート✓ ネイティブ、成熟、10年の歴史
イシュー、GitHubスタイルのコードレビュー、エコシステム· まだなし; 自分で用意するか、ロードマップにあり✓ ネイティブ、成熟、10年の歴史

よくある質問。

エージェントを変更する必要がありますか?

いいえ。シェルコマンドを実行できるあらゆるコーディングエージェントは、Claude Code、Codex、Cursorを含むoak CLIを使用できます。上部にある「エージェントセットアップをコピー」ボタンは、オンボーディング手順(インストール、サインイン、Oakエージェントスキル、Gitとは異なるルール)をコピーして、エージェントに直接貼り付けることができます。

OakはGitよりなぜ速いのですか?

Oakはコンテンツをハッシュで保存し、大きなファイルをチャンクに分割し、ファイルが読み取られたときにのみフェッチするため、ツリー全体を再ハッシュしたり、すでに持っているデータを転送したりしません。Gitはコールドリポジトリ初期化とプロセス起動では依然として高速です。

OakはCIを実行しますか?

はい、ご自身のマシンで実行します。それらをランナーとして登録し、.oak/workflows/*.ymlにGitHub Actionsスタイルのワークフローを配置すると、プッシュまたはマージ時、または自分でトリガーしたときに実行されます。シークレットはリポジトリごとに暗号化され、ログはライブでストリーミングされます。Oakは、CIが赤であるか実行中である間はブランチをmainにsquashせず、oak merge --waitはそれが完了するのを待ちます。

Gitにエクスポートできますか?

oak export <dest>は、すべてのコミットの作成者、メールアドレス、タイムスタンプを保持しながら、完全なブランチ履歴を標準のGitリポジトリにリプレイします。標準のgit cloneも、現在のmainツリーを提供する読み取り専用エンドポイントに対して機能します。

Oakは私のコードでトレーニングしますか?

いいえ。Oakはユーザーコードでモデルをトレーニングせず、あなたの代わりにAIコールを実行しません。Oakと並行して実行するコーディングエージェントは、独自のプライバシーポリシーを持つ独立した統合です。

Oakはどのプラットフォームをサポートしていますか?

CLIはmacOS(Apple SiliconおよびIntel)、Linux(x86_64)、Windows(x86_64)で実行されます。遅延マウントはmacOSではFSKit、LinuxではFUSE、WindowsではProjFSを使用します。curl -fsSL oak.space/install | shでインストールするか、Windowsではirm https://oak.space/install.ps1 | iexでインストールします。Linux ARM64バイナリはGitHubリリースページで提供されます。それらのインストーラーサポートはロードマップにあります。

CLIからのファイルフィードバック

あなたのエージェントは、あなたよりも先に摩擦に遭遇します。oak feedback -m "…" --jsonは、ターミナルから直接バグまたは機能リクエストを送信します。それらを自動的に実行させるには、これをCLAUDE.mdまたはAGENTS.mdに追加してください。エージェントに追加のトークンがかかることは承知しており、本当に感謝しています。

Oakの摩擦に注意してください: バグ、追加のツール呼び出し、トークン、またはエンドツーエンドフローでのウォールクロック時間を消費するもの、または回避しなければならなかった機能不足。
直ちに提出し、続行してください:
oak feedback -m "bug:|friction:|feature: <goal in one sentence; exact commands and output; the counted cost or expected-vs-actual; the concrete fix>" --json
1つの問題につき1つのレポート。