Tutorial Cursor Origin: Penyiapan CLI, Pencerminan GitHub, dan Pull Request

Apa Itu Cursor Origin?

Cursor Origin adalah sebuah Git forge. Layanan ini meng-host repositori, mencerminkan proyek GitHub, dan mendukung pull request serta penelusuran kode. Repositori Origin juga berfungsi dengan agen cloud dan otomatisasi milik Cursor.

Apa perbedaan antara Cursor Origin dan GitHub?

Origin tidak mencakup setiap fitur GitHub. Repositori publik tidak didokumentasikan, dan cermin mengecualikan Issues GitHub, workflow GitHub Actions, dan rahasia Actions. GitHub tetap menjadi platform yang lebih luas untuk repositori publik, Issues, Actions, dan aplikasi pihak ketiga, jadi Origin saat ini adalah layanan yang cakupannya lebih sempit.

Perbedaan utama terletak di bawah alur kerja Git yang familier: Cursor membangun lapisan penyimpanan terpisah untuk volume branch dan commit yang dihasilkan oleh agen. Cursor menyebut fokus ini "agent scale": beban kerja di mana banyak agen membuat branch, commit, dan membuka pull request pada repositori yang sama.

Mengapa Cursor membangun host Git sendiri?

Desain penyimpanan menjelaskan mengapa Cursor membangun host Git baru alih-alih menambahkan antarmuka lain ke host yang sudah ada.

Tulisan rekayasa Cursor tentang Continuity memaparkan host Git yang ada sebagai menyimpan satu repositori di beberapa server dan menerima push setelah mayoritas setuju. Cursor mengatakan model ini lebih mahal ketika sistem memiliki ribuan repositori berumur pendek atau push yang sering ke satu repositori.

Bagaimana penyimpanan Continuity milik Cursor Origin bekerja?

Continuity, atau "Cnt", adalah sistem penyimpanan di balik Origin. Sistem ini menyimpan write-ahead log di penyimpanan objek yang kompatibel dengan S3 sebagai sumber kebenaran. Repositori Git di disk lokal adalah cache hangat yang dapat dibangun ulang dari log.

Continuity menyimpan penulisan Git sebagai objek. Gambar oleh Penulis.

Karena log objek adalah catatan yang sebenarnya, Cursor dapat menambahkan replika baca untuk repositori yang sibuk dan menghapusnya saat permintaan menurun. Dalam pengujian Cursor, throughput baca meningkat saat replika ditambahkan, hingga 100 replika. Sistem menangani hingga 120 push per detik pada S3 standar, tetapi angka-angka tersebut belum diuji oleh benchmark independen.

Bagi pengguna, dampak utamanya lebih sederhana: repositori yang sibuk dapat menambah kapasitas baca, sementara repositori berumur pendek tidak perlu salinan lokal permanen di setiap server.

Siapa yang dapat mengakses Cursor Origin?

Origin tersedia pada paket Pro, Teams, dan Enterprise, tetapi tidak pada paket gratis. Akses diluncurkan bertahap, jadi paket yang memenuhi syarat tidak menjamin tab Codebase langsung muncul. Pada Pro, Anda memiliki namespace individual dan mengklaim nama codebase sendiri.

Admin Enterprise dapat menonaktifkannya untuk organisasi mereka. Ringkasan Cursor menyebutkan anggota tim mana pun dapat mengklaim nama codebase pertama, sementara halaman Codebase Settings menyatakan admin tim harus mengklaimnya. Periksa izin tersebut di tim Anda sebelum penyiapan.

Apa Itu Cursor Origin CLI?

Origin menyertakan alat baris perintah sendiri untuk autentikasi, repositori, pull request, dan konfigurasi akun.

Cursor Origin CLI vs. Cursor Agent CLI

CLI Origin adalah biner terpisah, origin, dari Agent CLI milik Cursor, yang berjalan sebagai agent. 

Saya mendapati penamaannya mudah tertukar karena origin juga merupakan nama konvensional untuk remote Git. Dalam artikel ini, "push ke origin" berarti remote Git, sedangkan "menjalankan origin" berarti CLI.

Platform mana yang mendukung Origin CLI?

Cursor mendokumentasikan macOS, Linux, dan Windows melalui WSL. Pada saat pengujian saya, Windows berarti WSL karena belum ada penginstal native.

Jika Anda mengikuti di Windows, buka terminal Ubuntu sebelum memasang CLI. Menjalankan penginstal shell di PowerShell bukanlah penyiapan yang sama.

Perintah-perintah Cursor Origin CLI

Saat ini Cursor Origin CLI memiliki sembilan grup perintah.

Sebagian besar perintah repositori membaca target dari remote Git bernama origin. Opsi -R owner/repo menetapkan target secara langsung, yang berguna dalam skrip yang dapat berjalan pada beberapa repositori. Perintah ruleset hanya menampilkan aturan push dan merge yang ada; tidak mengubahnya.

Cara Memasang dan Masuk ke Cursor Origin CLI

Cursor menyediakan CLI melalui skrip shell alih-alih pengelola paket. Perintahnya berasal dari halaman pemasangan Cursor di sini.

Cara memasang Cursor Origin CLI

Pemasangannya cukup satu baris:

curl -fsSL https://downloads.cursor.com/origin/install.sh | sh

Penginstal menempatkan origin di ~/.local/bin/origin. Jika tim Anda meninjau skrip pemasangan sebelum menjalankannya, unduh skrip terlebih dahulu alih-alih langsung mem-pipe ke sh.

Memperbaiki galat "command not found" pada Origin CLI

Jika shell Anda tidak menemukan origin setelah pemasangan, tambahkan direktori tersebut ke PATH:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Ganti ~/.zshrc dengan ~/.bashrc pada bash. Ini perbaikan satu kali per mesin.

Memeriksa pemasangan dan login

Jalankan origin --version dan origin --help untuk mengonfirmasi pemasangan, lalu gunakan origin auth login untuk membuka alur masuk browser Cursor.

Berikut tampilan keluaran verifikasi di WSL:

Versi dan keluaran bantuan Origin CLI. Gambar oleh Penulis.

Di lingkungan headless, CLI akan mencetak URL. Login juga mengonfigurasi credential helper Git, sehingga remote Origin berfungsi tanpa token Git terpisah. Jalankan origin auth status setelahnya untuk memeriksa sesi.

Menggunakan kunci API Cursor tanpa browser

Untuk CI atau skrip, jalankan origin auth login --api-key <key> atau setel CURSOR_API_KEY sebelum origin auth login. Jangan pernah menyimpan kunci di file yang dikomit. CURSOR_AUTH_TOKEN berbeda dan mengharapkan bearer token.

Cara Membuat, Mengklon, dan Melakukan Push ke Repositori Cursor Origin

Setelah masuk, Anda dapat membuat repositori dari laman web atau CLI. Proses push menggunakan perintah Git standar.

Membuat repositori dengan origin repo create

Dari cursor.com/codebase, pilih New, masukkan nama, dan pilih visibilitas Internal atau Private. 

Dari CLI, origin repo create my-project menggunakan namespace akun Anda. Sertakan pemilik, seperti origin repo create acme/my-project, untuk namespace tim. Flag opsional --default-branch mengubah default server dari main.

Perintah origin repo clone acme/my-project mengklon repositori melalui HTTPS dengan login yang disimpan oleh CLI.

Melakukan push commit pertama ke Origin

Setelah push pertama, repositori akan muncul di Codebase:

Repositori sudah di-push dan ditampilkan di Codebase. Video oleh Penulis.

Untuk repositori kosong yang benar-benar baru, klon, tambahkan satu file, lalu push:

git clone https://origin.cursor.com/{owner}/{repo}.git
cd {repo}
echo "# {repo}" > README.md
git add .
git commit -m "Initial commit"
git push -u origin main

Jika Git melaporkan galat izin .git/config.lock di bawah /mnt di WSL, klon di bawah ~ sebagai gantinya. Itu memperbaiki galat pada pengujian saya.

Setelah push, buka Codebase dan pastikan commit muncul. Tab Code menampilkan pohon file dan riwayat commit. Tekan T untuk Go to file, atau gunakan kolom pencarian untuk mencari kode.

Melakukan push repositori Git yang sudah ada ke Origin

Jika Anda sudah memiliki proyek dengan riwayat Git, jalankan git remote -v terlebih dahulu. Perintah di bawah ini hanya berlaku ketika repositori belum memiliki remote bernama origin:

git remote add origin https://origin.cursor.com/{owner}/{repo}.git
git push -u origin main

Jika origin sudah menunjuk ke GitHub, gunakan nama remote lain seperti cursor alih-alih mengganti URL yang ada. Perintah Origin CLI tidak akan menyimpulkan repositori dari nama itu, jadi sertakan -R owner/repo saat menjalankannya.

Cara Mencerminkan Repositori GitHub di Cursor Origin

Cermin menyalin proyek GitHub yang ada ke Origin dan menjaga kedua layanan tetap terhubung.

Persyaratan pencerminan GitHub pada Cursor Origin

Anda memerlukan akses Origin, aplikasi GitHub Cursor yang terhubung ke organisasi atau akun pemilik repositori, dan akses admin GitHub ke repositori tersebut. Akses tulis saja tidak cukup.

Memulai cermin GitHub di Cursor Origin

Dari cursor.com/codebase, pilih Sync from GitHub, pilih organisasi dan repositori, lalu konfirmasi. Alternatif CLI adalah origin repo create-mirrored owner/repo, dibahas di dokumen pencerminan Cursor.

Apa yang dicerminkan Cursor Origin dari GitHub

Origin mencerminkan data Git, tetapi tidak setiap fitur GitHub:

GitHub Actions tetap berjalan di GitHub. Integrasi Depot dan Buildkite berlaku untuk repositori yang di-host di Origin, bukan salinan tercermin.

Saat GitHub tetap menjadi source of truth

Saat repositori dicerminkan, push melalui Origin diteruskan ke GitHub. Detach from GitHub, di bawah Settings repositori, membuat salinan Origin berdiri sendiri tanpa mengubah repositori GitHub.

Cara Membuka dan Meninjau Pull Request di Cursor Origin

Pull request Origin menggunakan urutan branch, push, dan review yang sama seperti pada host Git lainnya. Panduan cara kerja pull request kami menerangkan urutan tersebut.

Membuat branch dan mendorong perubahan

Buat dan push branch kerja:

git checkout -b my-change
echo "Example change" >> README.md
git add README.md
git commit -m "Add example change"
git push -u origin my-change

Git sudah menyelesaikan bagiannya; perintah berikutnya milik Origin.

Membuka pull request dengan Origin CLI

Perintah repositori menyimpulkan target dari remote Git bernama origin. Jalankan origin pr create, atau sertakan -R owner/repo untuk menetapkan repositori secara langsung. Perintah ini secara default membuat draft; sertakan --status open untuk PR yang siap ditinjau.

Meninjau pull request di Cursor Origin

CLI menyertakan origin pr list, origin pr view, origin pr diff, dan origin pr checks. Tanpa aplikasi CI yang dikonfigurasi, origin pr checks mencetak No checks reported. dan keluar dengan kode 1 pada pengujian saya.

Kode keluar tersebut penting dalam skrip shell yang menggunakan set -e, karena tab Checks yang kosong dapat menghentikan skrip meski pull request-nya sendiri baik-baik saja.

Tinjauan pull request dengan empat tab. Gambar oleh Penulis.

Di tampilan web, setiap pull request memiliki empat tab: Activity, Commits, Checks, dan Files Changed, ditambah permintaan reviewer, komentar inline, dan tombol merge. Laman web menampilkan konflik merge, dan origin pr status --conflict-status melaporkannya dari terminal.

Terminal juga mendukung origin pr merge. Pull request yang dibuat pada repositori yang di-host di Origin tetap berada di Origin, sementara aktivitas pada repositori tercermin dikirim kembali ke GitHub.

Akses Tim dan Izin Repositori di Cursor Origin

Izin Origin ada di tingkat codebase dan repositori.

Pengaturan codebase vs. pengaturan repositori

Pengaturan codebase berlaku untuk seluruh tim: siapa yang dapat menyalakan Origin, membuat repositori, dan memasang aplikasi. Pengaturan repositori cakupannya untuk satu repositori dan mencakup General, Permissions, Rules dan Protections, serta Apps, meskipun dokumentasi Cursor memperingatkan bahwa layar Permissions dan Rules sedang didesain ulang.

Jika rekan tim dapat menggunakan Origin tetapi tidak dapat membuka satu repositori, periksa izin repositori tersebut alih-alih pengaturan tingkat tim.

Repositori Internal vs. Private

Ada dua jenis repo dengan akses terbatas:

• Internal repositories terlihat oleh anggota tim yang memiliki akses codebase. 
• Private repositories hanya terlihat oleh anggota yang diberi akses secara langsung atau melalui izin codebase. Mengubah repositori menjadi private mempertahankan siapa pun yang melakukan perubahan sebagai admin.

Cara memeriksa akses repositori Cursor Origin

Perintah origin repo list menampilkan setiap repositori yang terlihat oleh akun saat ini. Untuk meninjau siapa yang dapat mengakses satu repositori, buka Settings, lalu Permissions.

Praktik Terbaik Cursor Origin

Ada tiga hal yang sangat penting untuk diingat saat bekerja dengan Origin:

• Sebelum menghapus atau mengonfigurasi ulang repositori, konfirmasikan nilai lengkap owner/repo dan periksa remote-nya. 

• Hindari -y sampai target terverifikasi. 

• Halaman izin Cursor saling bertentangan, jadi periksa dokumentasi terbaru sebelum mengotomatiskan perubahan akses.

Cursor Origin vs. GitHub: Perbandingan Fitur

Origin terikat pada alur kerja agen Cursor, sedangkan GitHub mencakup ekosistem repositori yang lebih luas.

Hosting Git, pull request, dan CI/CD

Alih-alih mengulang setiap bagian, berikut versi singkat pembagian fiturnya:

Baris agen adalah yang memerlukan konteks.

Cursor Origin vs. GitHub untuk alur kerja agen

Kedua platform memungkinkan agen bekerja terhadap repositori. Origin menjaga loop tersebut di dalam Cursor; GitHub menawarkannya melalui panel Agents dan alat Copilot, termasuk CLI yang sudah GA.

Kapan menggunakan Cursor Origin, GitHub, atau keduanya

• Gunakan Origin saat repositori bersifat internal atau private, sebagian besar pekerjaan agen sudah terjadi di dalam Cursor, dan penyiapan deployment atau CI Anda dapat berjalan melalui Vercel, Depot, atau Buildkite.
• Pertahankan GitHub sebagai host utama ketika proyek bersifat publik, Issues dan Actions adalah bagian dari alur kerja harian, atau tim bergantung pada marketplace aplikasi GitHub.
• Gunakan keduanya saat Anda menginginkan penelusuran kode dan alur kerja agen milik Origin tanpa memindahkan repositori sumber. Cermin menjaga aktivitas push dan pull request tetap terikat ke GitHub sembari membuat kode yang sama tersedia di Origin.

Penutup

Saya berangkat dari pemasangan WSL baru hingga membuka pull request Origin menggunakan alur branch, commit, dan push yang sama seperti di GitHub. CLI tidak mengubah cara Git bekerja; perbedaan Origin muncul di sekitar hosting, izin, dan pencerminan.

Setelah menggunakannya, saya akan memperlakukan Origin sebagai pendamping GitHub, bukan pengganti penuh. Pencerminan adalah titik masuk paling praktis untuk repositori yang sudah ada karena GitHub dapat tetap menjadi otoritas. Proyek publik dan alur kerja yang bergantung pada Actions masih memiliki sedikit alasan untuk pindah.

Untuk bacaan terkait, panduan Cursor Automations kami membahas tugas agen yang berjalan terhadap repositori yang sudah ada. Panduan kami tentang apa itu GitHub dan cara menggunakannya menjelaskan alur kerja GitHub secara lebih rinci.