Worktree

Worktree melakukan checkout branch lain dari repositori yang sama ke foldernya sendiri. Dengan satu worktree per agen, beberapa agen bisa mengerjakan proyek yang sama secara bersamaan tanpa mengedit berkas satu sama lain. PATerminal membuat worktree dan membukanya sebagai sesi baru dalam satu langkah.

Ditulis untuk PATerminal v1.8.3

Buat worktree

  1. Di panel yang berada di dalam repositori, klik Worktree di bilah panel (juga ada di daftar branch).
  2. Di bawah Buat dari, pilih Branch atau Pull request.
  3. Pilih Branch dasar (atau pull request-nya) dan masukkan nama Branch baru.
  4. Pilih Tempat pembuatan dan, jika mau, catatan sesi.
  5. Tekan Buat. Sesi baru terbuka di folder worktree.

Lokasi worktree

Di luar repositori (default)
Worktree dikelompokkan dalam folder yang dinamai sesuai repositori, misalnya ~/worktrees/acme-app/feature-login. Masukkan path absolut, ~, atau ... .gitignore Anda tidak disentuh.
Di dalam repositori
Worktree ditempatkan di folder di dalam repositori. Jika folder itu belum diabaikan, folder tersebut ditambahkan ke .gitignore di root (sebagai perubahan source biasa).

Salin berkas yang diabaikan

Worktree baru tidak berisi berkas Anda yang di-gitignore, jadi biasanya belum bisa dijalankan. Dengan Berkas yang diabaikan: Salin dari checkout ini (default), PATerminal menyalin berkas seperti .env, node_modules, dan .venv dari checkout saat ini ke worktree baru, dengan indikator progres. Pilih Jangan salin untuk melewatinya.

Worktree dari pull request

Pilih Pull request sebagai sumber untuk menampilkan pull request yang terbuka (lewat gh Anda). PATerminal membuat worktree pada branch PR dan membukanya sebagai sesi — ideal untuk mereview atau memperbaiki PR sementara checkout utama Anda tetap bekerja. Worktree yang sudah ada untuk branch itu akan dipakai ulang.

Kelola worktree

Daftar worktree di jendela Git menampilkan setiap worktree beserta branch dan statusnya (saat ini, utama, terkunci, hilang). Hapus satu, atau pilih beberapa lalu tekan Hapus yang dipilih. Menghapus worktree tidak menghapus branch-nya; worktree utama dan worktree saat ini tidak bisa dihapus. Hapus paksa ditawarkan saat Git menolak karena ada perubahan lokal.

Default worktree

Pengaturan → Lokasi default worktree menentukan lokasi default dan apakah berkas yang diabaikan disalin. Aktifkan Automatically fill in the branch name untuk mendapatkan nama dari tanggal, waktu, dan akhiran acak pendek. Default ini juga berlaku saat worktree dibuat dari issue atau oleh mode pasangan.

Masih buntu?

Lihat tanya jawab, atau kirim email berisi OS, versi PATerminal, dan apa yang sudah Anda coba. Kami membalas setiap pesan.