Tutorial Oak VCS: Alternatif Git yang Didesain Khusus untuk AI Agent Workflow
AW
Axel W

Dipublikasikan · 4 menit baca

Tutorial Oak VCS: Alternatif Git yang Didesain Khusus untuk AI Agent Workflow

git
software-engineering
github
tutorial

Oak adalah version control system baru yang dibangun dari nol untuk era AI agent. Tidak seperti Git yang dirancang untuk developer manusia, Oak mengutamakan workflow agentik: clone parsial, branch review otomatis, dan integrasi native dengan coding assistant seperti Cursor, Claude Code, dan Codex.

Dalam tutorial ini, kita akan mempelajari cara menginstal Oak, mengonfigurasi workspace untuk AI agent, dan menggunakan fitur-fitur unik seperti oak mount untuk lazy working tree serta oak space untuk multi-repo management. Jika kamu sering menggunakan AI agent untuk coding, Oak bisa menggantikan Git sebagai fondasi workflow-mu.

Apa itu Oak VCS?

Oak dikembangkan oleh tim di balik Oak Space dengan fokus pada tiga prinsip utama: kecepatan clone untuk agent yang tidak membutuhkan full history, review branch yang terstruktur untuk review otomatis, dan atomic operations yang aman untuk agent yang sering melakukan batch changes.

Fitur utama Oak yang membedakannya dari Git:

  • Lazy Working Tree: oak mount memuat repository tanpa full clone, ideal untuk agent yang hanya membaca sebagian codebase

  • Agent Space: oak space new membuat workspace multi-repo untuk organisasi

  • Branch Review: Setiap branch mendapatkan review page dengan metadata JSON untuk konsumsi agent

  • Finish Saga: Preflight checks sebelum push untuk mencegah agent merusak canonical checkout

Langkah 1: Instalasi Oak CLI

Saat ini Oak CLI tersedia sebagai binary yang bisa diunduh dari repository GitHub. Pastikan Rust toolchain sudah terinstal jika ingin build dari source.

Untuk Linux dan macOS, jalankan perintah berikut:

# Clone repository Oak (gunakan git untuk menginstal oak)
git clone https://github.com/oakvcs/oak.git
cd oak
cargo build --release

# Pindahkan binary ke PATH
sudo cp target/release/oak /usr/local/bin/

Setelah instalasi, verifikasi dengan:

oak --version

Oak juga menyediakan binary pre-built untuk Windows. Cek halaman rilis di GitHub Releases untuk versi terbaru.

Langkah 2: Setup Repository Pertama

Oak menggunakan format repository yang mirip Git tetapi dengan ekstensi .oak sebagai marker. Untuk mengkloning repository Oak, gunakan perintah:

oak clone oak/oak

Perintah ini akan membuat clone lengkap ke branch feature lokal. Jika kamu hanya ingin membaca repository tanpa mengunduh seluruh history, gunakan oak mount:

oak mount oak/oak

Mount membuat virtual working tree yang lazy: file-file hanya diunduh saat diakses. Ini sangat berguna untuk AI agent yang perlu memahami codebase besar tanpa menunggu clone berjam-jam.

Langkah 3: Konfigurasi Agent Space

Agent Space adalah konsep workspace di Oak yang memungkinkan satu agent bekerja di banyak repository sekaligus. Ini mirip dengan Git submodules tetapi lebih terintegrasi.

Buat space baru untuk organisasimu:

oak space new my-org

Space akan membuat direktori dengan struktur yang terisolasi. Di dalam space, kamu bisa menambahkan multiple repositories:

cd my-org
oak clone repo-frontend
oak clone repo-backend
oak clone repo-ml

Setiap repository dalam space tetap independen, tetapi agent bisa melakukan operasi cross-repo seperti dependency checking atau batch refactoring.

Langkah 4: Workflow Branch dan Review

Di Oak, branch dibuat untuk setiap task dan review-nya terstruktur dalam format yang bisa dibaca agent. Setelah melakukan changes, push branch untuk review:

oak switch --clean feature/new-api
# lakukan perubahan...
oak commit -m "Implement new API endpoint"
oak commit --push

Oak akan memvalidasi branch sebelum push dengan preflight checks: memastikan remote reachable, autentikasi valid, dan tidak ada conflict yang terlewat. Jika semua checks lolos, Oak menjalankan finish saga yang menggabungkan commit, push, dan describe dalam satu operasi atomic.

Review page untuk branch bisa diakses via web interface Oak Space. Setiap review menyertakan metadata JSON yang berisi:

  • Daftar file yang berubah

  • Statistik line changes

  • Recommended action untuk agent (merge, close, atau revise)

Langkah 5: Integrasi dengan AI Agent

Oak menyediakan kontrak JSON untuk setiap operasi, membuatnya ideal untuk integrasi dengan AI agent. Beberapa pola integrasi yang bisa dicoba:

  • Codex: Copy skill file dari .codex/skills/publish-report ke direktori skills agent-mu

  • Claude Code: Gunakan plugin marketplace dengan perintah /plugin install

  • Generic Agent: Gunakan output JSON dari oak status dan oak diff sebagai context untuk LLM

Contoh penggunaan JSON output untuk agent:

oak status --json
oak diff --json
oak merge --json feature/new-api

Setiap perintah di atas menghasilkan output JSON yang bisa diparsing oleh agent untuk membuat keputusan otomatis tanpa parsing text yang rapuh.

Perbandingan Oak vs Git untuk Workflow Agentik

Untuk memahami mengapa Oak dibutuhkan, mari bandingkan beberapa asumsi fundamental Git yang sering bertabrakan dengan perilaku AI agent:

  • Full Clone Assumption: Git mengasumsikan developer meng-clone seluruh repository dengan history lengkap. Agent seringkali hanya butuh membaca sebagian kecil file untuk task tertentu. Oak mount memungkinkan lazy loading tanpa mengunduh riwayat commit yang tidak relevan.

  • Human Review Assumption: Git dirancang untuk review oleh manusia yang membaca diff baris per baris. Agent lebih efisien dengan structured JSON metadata. Oak menghasilkan review contract dalam format JSON yang bisa dikonsumsi programatis.

  • Destructive Operations: Command seperti git reset --hard atau git rebase -i sangat berbahaya untuk agent yang mungkin salah memahami intent. Oak mendesain operation set-nya untuk fail-safe dengan preflight checks sebelum setiap mutasi.

Oak bukan berarti menggantikan Git sepenuhnya untuk semua use case. Untuk proyek tradisional dengan team developer manusia, Git tetap menjadi standar emas. Namun, untuk workspace yang didominasi AI agent atau hybrid team, Oak menawarkan fondasi yang lebih aman dan efisien.

Kesimpulan

Oak VCS hadir sebagai jawaban atas kebutuhan version control modern di era AI agent. Dengan fitur seperti lazy mount, agent space, dan finish saga, Oak mengurangi friction dalam workflow agentik yang seringkali terhambat oleh asumsi Git yang berorientasi pada developer manusia.

Meski masih dalam tahap awal dan ekosistemnya belum seluas Git, Oak layak dicoba untuk tim yang intensif menggunakan AI coding assistant. Dokumentasi lengkap tersedia di oak.space/docs dan source code bisa ditemukan di GitHub.