Folder tertaut

Banyak direktori, satu proyek
untuk setiap agen AI yang Anda jalankan

Sebuah game di satu folder dan port-nya ke versi engine yang lebih baru di folder lain. Aplikasi web dan API yang dipanggilnya, di dua repositori. Library bersama di samping aplikasi yang memakainya. Agen Anda butuh kedua sisi, dan memindahkan folder-folder itu ke bawah satu induk akan merusak setup yang sudah berjalan baik.

Sebagai gantinya, tautkan folder lain itu ke proyek. Folder tetap di tempatnya dan mempertahankan kontrol versinya sendiri. Setiap agen yang Anda jalankan di proyek mendapatkannya: lewat --add-dir di Claude Code, Codex, GitHub Copilot CLI, Antigravity CLI, Kimi Code, dan Mistral Vibe, dan lewat brief-nya untuk CLI lainnya. Tab Perubahan lalu meninjau dan meng-commit setiap repositori.

Satu proyek, tiga repositori
  • /work/web-appFolder proyek · git
  • /work/apiFolder tertaut · git
  • /work/shared-libFolder tertaut · git
Saat dijalankan
Claude Code--add-dir=/work/api --add-dir=/work/shared-lib
Codex--add-dir=/work/api --add-dir=/work/shared-lib
GitHub Copilot CLI--add-dir=/work/api --add-dir=/work/shared-lib
OpenCodefolder dicantumkan di brief-nya

Satu proyek, tiga repositori: setiap agen dimulai di folder proyek dan mendapatkan dua folder lainnya, dalam bentuk yang dipahami CLI-nya.

Agen dimulai di satu folder, dan sebagian besar CLI menahannya di sana. Agen sering bisa membaca di sekitarnya, tetapi mengedit di luar direktori kerjanya berarti menghadapi permintaan izin, penolakan sandbox, atau flag yang harus Anda ingat di setiap peluncuran. Itu baik-baik saja sampai pekerjaan meliputi dua tempat: aplikasi dan API-nya, sebuah game dan salinannya di engine yang lebih baru, sebuah library dan proyek-proyek yang memakainya.

Solusi yang biasa dipakai selalu ada harganya. Memindahkan kedua folder ke bawah satu induk merusak jalur, skrip, dan setup editor yang tadinya berjalan. Symlink membingungkan sebagian alat dan menyembunyikan lokasi asli file. Mengetik --add-dir di setiap peluncuran memang berhasil, sampai satu peluncuran saat Anda lupa.

Folder tertaut adalah daftar yang disimpan di proyek. Anda menambahkan folder sekali saja, di Pengaturan proyek, Umum, Folder tertaut. Sejak itu setiap agen di proyek, baik Anda jalankan dari daftar agen, dari tiket backlog, maupun dari ponsel, mendapatkan folder-folder tersebut, dan setiap folder tetap memiliki repositorinya sendiri.

Apa yang dilakukan folder tertaut

Sebuah daftar di proyek, dibaca di setiap peluncuran. Proyek tanpa folder tertaut berfungsi persis seperti sebelumnya.

Folder tetap di tempatnya

Pilih folder dengan pemilih folder sistem. Tidak ada yang dipindahkan, disalin, atau dibuatkan symlink, dan setiap folder tetap memiliki repositori, branch, dan riwayatnya sendiri. Maksimal sepuluh folder per proyek.

Flag yang tepat untuk setiap CLI

Claude Code, Codex, GitHub Copilot CLI, Antigravity CLI, Kimi Code, dan Mistral Vibe menerima setiap folder lewat flag --add-dir mereka sendiri, baik saat agen dimulai dari awal maupun saat melanjutkan sesi.

Disebutkan di brief agen

Setiap agen, apa pun CLI-nya, juga mendapatkan blok singkat di brief-nya: daftar folder, bahwa folder itu bagian dari proyek, dan bahwa git dijalankan dari dalam masing-masing folder. CLI tanpa flag menjangkaunya lewat jalur lengkap jika sandbox mereka mengizinkan.

Commit setiap repositori

Di tab Perubahan, pemilih repositori menampilkan folder proyek dan setiap folder tertaut yang merupakan repositori git. Pilih salah satu untuk melihat diff-nya, lalu stage, commit, dan push.

Sama di ponsel

Agen yang dijalankan dari aplikasi seluler AgentsRoom mendapatkan flag dan brief yang sama, karena desktop yang menyusun perintah peluncurannya. Ponsel menampilkan folder tertaut di menu proyek, dan layar Perubahan-nya juga menawarkan repositori tertaut.

Diperiksa saat peluncuran

Folder yang hilang dari disk, misalnya di drive yang sedang dicabut, tetap ada di daftar dengan peringatan dan dilewati saat peluncuran, dengan satu baris di terminal. Folder proyek itu sendiri dan duplikat akan ditolak.

Pengaturan proyek AgentsRoom, Umum, Folder tertaut: dua folder yang ditautkan ke proyek my-shop, my-shop-api dan shared-ui, dengan tombol Tambahkan folder dan catatan bahwa Claude Code, Codex, Copilot, Antigravity, Kimi, dan Mistral Vibe menerimanya saat dijalankan
Kartu Folder tertaut di Pengaturan proyek, Umum: dua repositori yang ditautkan ke proyek, masing-masing dibiarkan di tempatnya. Catatan di bawah daftar menyebutkan CLI mana yang menerimanya lewat flag dan bagaimana CLI lain menjangkaunya.

Cara kerjanya

Empat langkah, dan dua langkah pertama hanya sekali per proyek.

  1. 1

    Buka pengaturan proyek

    Pengaturan proyek, Umum, Folder tertaut. Kolom ini menyebutkan CLI mana yang menerima folder lewat flag dan bagaimana CLI lain menjangkaunya.

  2. 2

    Tambahkan folder

    Tambahkan folder membuka pemilih folder sistem, dan folder langsung disimpan. Tanda silang di sampingnya menghapusnya dari proyek nanti: tidak ada yang berubah di disk.

  3. 3

    Jalankan agen

    Jalankan agen mana pun di proyek seperti biasa: dari daftar agen, dari tiket backlog, atau dari ponsel Anda. Agen dimulai di folder proyek dan juga memiliki folder tertaut.

  4. 4

    Tinjau dan commit setiap repositori

    Buka tab Perubahan dan pilih repositori: folder proyek atau folder tertaut. Baca diff-nya, lalu stage, commit, dan push di sana. Setiap folder menyimpan riwayatnya sendiri.

Tab Perubahan AgentsRoom dengan pemilih repositori diatur ke my-shop-api (folder tertaut), pemberitahuan Folder tertaut, branch main dengan 2 perubahan, dan dua file yang berubah, products.ts dan shipping.ts
Tab Perubahan pada repositori tertaut: pilih repositori itu di pemilih repositori, dan branch, perubahan, serta tombol commit-nya menjadi miliknya sendiri. Commit otomatis dan worktree per tiket tetap berlaku di folder proyek.

Claude Code dan Codex sudah bisa menambahkan direktori. Inilah yang berubah

Claude Code menerima --add-dir saat dimulai dan /add-dir selama sesi, dan menyimpan daftar permanen di additionalDirectories dalam file pengaturannya. Direktori yang ditambahkan mendapat akses file dengan aturan izin yang sama seperti direktori kerja. Dari direktori yang diberikan lewat --add-dir atau /add-dir, Claude Code juga memuat keterampilan, perintah, dan subagen, tetapi tidak memuat CLAUDE.md-nya kecuali CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 diatur; direktori yang dicantumkan di file pengaturan hanya mendapat akses file. Diperiksa pada dokumentasi Claude Code dan versi 2.1.300 pada Oktober 2026.

Codex juga punya --add-dir, yang membuat sebuah direktori bisa ditulis di samping workspace utama, dan writable_roots di bawah sandbox_workspace_write dalam config.toml untuk daftar permanen (codex-cli 0.162.1). GitHub Copilot CLI, Antigravity CLI, Kimi Code, dan Mistral Vibe masing-masing punya --add-dir sendiri.

Jadi flag-nya bukan hal baru. Yang ditambahkan AgentsRoom adalah daftar yang disimpan di proyek dan diberikan ke setiap agen di setiap peluncuran, dalam bentuk yang diharapkan setiap CLI (Claude Code membutuhkan flag dan folder dalam satu potong, seperti --add-dir=/work/api, kalau tidak opsi itu menelan prompt yang mengikutinya), brief yang sama untuk CLI yang tidak punya flag, peluncuran dari ponsel yang mendapatkan folder yang sama, dan tab Perubahan yang meng-commit setiap repositori. AgentsRoom tidak mengatur CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD untuk Anda.

Yang perlu diketahui

  • Commit otomatis saat tiket selesai, satu worktree per tiket, dan diff langkah tim tetap berlaku di folder proyek. Di folder tertaut, Anda meninjau dan meng-commit secara manual.
  • Daftar ini disimpan di setiap komputer, karena jalur seperti D:\Games\UE5 tidak berarti apa-apa di mesin lain. Tambahkan lagi folder-foldernya di komputer Anda yang lain.
  • Agen yang dijalankan di server jarak jauh lewat SSH tidak mendapatkan folder tertaut: itu adalah jalur di komputer ini. Satu baris di terminalnya memberitahukan hal itu.
  • OpenCode, Aider, Grok Build, Amp, oh-my-pi, Freebuff, Devin, dan Cursor tidak punya flag untuk direktori tambahan. Agen mereka menemukan folder di brief-nya dan menjangkaunya lewat jalur lengkap hanya jika sandbox mereka sendiri mengizinkan.
  • Ponsel menampilkan daftar tetapi tidak bisa mengeditnya: folder dipilih dengan pemilih folder di komputer.
  • Maksimal sepuluh folder per proyek, karena perintah peluncuran punya batas panjang di Windows.

Pertanyaan yang sering diajukan

Bagaimana cara memberi Claude Code akses ke beberapa direktori?

Di Claude Code sendiri: --add-dir diikuti jalur saat memulainya, /add-dir selama sesi, atau additionalDirectories di file pengaturan untuk daftar permanen. Di AgentsRoom, tambahkan folder sekali sebagai folder tertaut proyek (Pengaturan proyek, Umum, Folder tertaut): setiap agen Claude Code di proyek lalu dimulai dengan --add-dir untuk masing-masing folder, begitu juga agen dari CLI lain yang punya flag tersebut.

Bisakah Codex bekerja di beberapa repo?

Bisa. Codex dimulai di satu workspace, --add-dir membuat direktori lain bisa ditulis di sampingnya, dan writable_roots di config.toml menyimpan daftar permanen. AgentsRoom memberikan --add-dir ke setiap agen Codex di proyek untuk setiap folder tertaut, termasuk saat agen melanjutkan sesi, dan brief-nya memintanya menjalankan git dari dalam setiap repositori.

Bisakah satu proyek mencakup beberapa repositori git?

Bisa. Proyek tetap memiliki folder utamanya, tempat agen dimulai, dan menautkan repositori lain. Masing-masing mempertahankan kontrol versinya sendiri. Di tab Perubahan, pemilih repositori berpindah antara folder proyek dan setiap repositori tertaut untuk membaca diff-nya, meng-commit, dan mem-push-nya.

Apakah folder saya dipindahkan, disalin, atau dibuatkan symlink?

Tidak. AgentsRoom hanya menyimpan jalurnya dan memberikannya ke agen saat peluncuran. Tidak ada yang berubah di disk saat Anda menambahkan atau menghapus folder tertaut.

CLI agen mana saja yang mendapatkan folder tertaut?

Claude Code, Codex, GitHub Copilot CLI, Antigravity CLI, Kimi Code, dan Mistral Vibe menerima setiap folder lewat flag --add-dir mereka sendiri. OpenCode, Aider, Grok Build, Amp, oh-my-pi, Freebuff, Devin, dan Cursor tidak punya flag seperti itu: mereka menemukan folder di brief-nya dan membukanya lewat jalur lengkap jika sandbox mereka mengizinkan.

Apakah agen membaca CLAUDE.md dari folder tertaut?

Tidak secara default. Claude Code memuat keterampilan, perintah, dan subagen dari direktori yang diberikan lewat --add-dir, tetapi CLAUDE.md-nya hanya jika CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 diatur, dan AgentsRoom tidak mengaturnya untuk Anda. Yang pasti didapat setiap agen adalah brief: lokasi setiap folder tertaut, bahwa folder itu bagian dari proyek, dan bahwa folder itu mempertahankan kontrol versinya sendiri.

Apakah worktree dan commit otomatis mencakup folder tertaut?

Tidak, keduanya tetap berlaku di folder proyek: satu worktree per tiket, commit otomatis saat tiket selesai, dan diff langkah tim. Di folder tertaut, tinjau dan commit secara manual dari tab Perubahan.

Apakah folder tertaut ikut ke komputer saya yang lain?

Tidak. Daftar ini disimpan di komputer tempat Anda membuatnya, karena jalur folder hanya ada di sana. Agen yang dijalankan di server jarak jauh lewat SSH juga tidak mendapatkan folder tersebut. Bagian lain dari proyek, yaitu agen, backlog, dan pengaturannya, tetap mengikuti akun Anda seperti biasa.

Apakah ini berfungsi di Windows dan Linux?

Ya, di macOS, Windows, dan Linux. Di Windows, huruf drive dan kedua jenis garis miring dikenali, dan setiap --add-dir diberi tanda kutip untuk PowerShell.

Anda mungkin juga suka

Beri agen Anda seluruh proyek

Unduh AgentsRoom, buka repositori utama Anda sebagai proyek, lalu tautkan repositori lainnya di Pengaturan proyek, Umum, Folder tertaut.

GratisUnduh AgentsRoom

Aplikasi pendamping: pantau agen Anda saat bepergian

Gunakan Claude, Codex, Antigravity CLI, atau penyedia AI lainnya.

Dapatkan ekstensi
Chrome Web Store

Kirim bug dan permintaan langsung ke backlog publik Anda.

Beberapa proyek
Multi-penyedia
Beberapa agen
Status langsung
File diff & commit
Pendamping mobile
Pratinjau langsung
Tim agen
Otomatisasi browser
Dev berbasis backlog
Pustaka prompt
Pustaka skill
Lihat semua fitur