Notiamo dapat menjalankan agen AI pada komentar dan tugas yang masih terbuka di sebuah proyek. Agen membuat perubahan, dan seseorang di tim Anda menyetujuinya. Sebuah eksekusi dapat berjalan di server Notiamo, atau di komputer milik Anda. Halaman ini membahas cara kedua: runner, program kecil yang Anda pasang di mesin Anda. Ini untuk tim agensi.

Apa itu runner

Runner menunggu eksekusi agen yang diantrekan organisasi Anda di Notiamo. Untuk setiap eksekusi, runner mengkloning repositori (atau terhubung ke situs WordPress), menjalankan Claude Code dengan instruksi eksekusi itu, mengirim ke Notiamo apa yang dilakukan agen, dan melaporkan saat eksekusi selesai.

  • Runner tidak menyimpan kredensial Claude. Runner menjalankan program claude yang sudah ada di mesin. Sesi runner memakai folder konfigurasinya sendiri, jadi terpisah dari milik Anda. Proses masuknya sendiri adalah urusan Claude Code, dan disimpan oleh Claude Code.
  • Ini bukan login Claude di dalam Notiamo. Notiamo tidak pernah melihat atau memakai akun Claude Anda. Runner hanya menjalankan Claude Code milik Anda sendiri, di mesin Anda, untuk pekerjaan Anda sendiri.

Memasangnya

Anda memerlukan:

  • Node.js 22 atau lebih baru;
  • Claude Code 2.1.314 atau lebih baru;
  • git 2.31 atau lebih baru;
  • di Linux dan WSL2: bubblewrap dan socat (Debian atau Ubuntu: sudo apt install bubblewrap socat). Di macOS tidak ada yang perlu dipasang lagi.

Lalu:

  1. Di Notiamo, buka Pengaturan › Eksekusi agen. Pada kartu Runner, tekan Runner baru dan beri nama. Salin tokennya. Token hanya ditampilkan sekali.
  2. Di mesin tersebut, jalankan:
npx @notiamo/runner init
  1. Tempel tokennya. init memeriksa bahwa Claude Code berfungsi, menjalankan proses masuk Claude Code untuk runner, lalu memasang layanan dan menjalankannya.
  2. Di proyek, atur Tempat agen dijalankan ke Mesin sendiri.

Setelah init selesai, runner berjalan. Runner menyala lagi sendiri setelah login atau restart.

Perintah

Perintah Fungsinya
npx @notiamo/runner init Menyiapkan runner: token, login Claude Code, pasang dan jalankan layanan.
npx @notiamo/runner@latest update Memperbarui runner ke versi terbaru. Token, nama, dan login tetap ada.
npx @notiamo/runner status Menunjukkan apakah layanan terpasang dan berjalan, beserta baris log terakhir.
npx @notiamo/runner logs Menampilkan 50 baris terakhir log.
npx @notiamo/runner stop Menghentikan layanan sampai login atau boot berikutnya.
npx @notiamo/runner uninstall Menghapus layanan. Folder runner tetap ada.
npx @notiamo/runner env <projectId> Membuat atau menampilkan file env yang diberikan mesin ini untuk eksekusi satu proyek.
npx @notiamo/runner start Berjalan di latar depan. Layanan menjalankan ini; Anda jarang membutuhkannya.

Layanannya adalah agen launchd com.notiamo.runner di macOS, Scheduled Task “Notiamo runner” di Windows, dan unit pengguna systemd notiamo-runner di Linux.

Dua runner di satu mesin

npx @notiamo/runner init --profile staging menyiapkan runner kedua yang terpisah. Runner itu punya folder sendiri (~/.notiamo-runner/profiles/staging) dan layanan sendiri. Tambahkan --profile staging pada setiap perintah runner tersebut. Nama profil terdiri dari huruf, angka, dan tanda hubung, 1 sampai 32 karakter.

Apa yang boleh dan tidak boleh disentuh agen

Setiap eksekusi mendapat file pengaturan Claude Code sendiri. Tiga hal menjaga agen tetap di tempatnya.

Alat file tetap di folder eksekusi. Alat file bawaan Claude (baca, ubah, tulis, cari) menolak apa pun di luar folder eksekusi. Setiap panggilan yang akan meminta izin ditolak, karena tidak ada orang yang menjawab.

Perintah shell berjalan di sandbox sistem operasi. Di macOS (Seatbelt) dan di Linux atau WSL2 (bubblewrap dan socat), setiap perintah yang dijalankan agen di shell dibatasi. Jika sandbox tidak bisa menyala, eksekusi tidak dimulai.

Tidak ada kredensial mesin yang sampai ke agen. Claude Code hanya mendapat daftar pendek variabel lingkungan (PATH, HOME, USER, LOGNAME, SHELL, LANG, LC_ALL, LC_CTYPE, TERM, TMPDIR, TZ, XDG_*, pengaturan proxy dan sertifikat) ditambah milik eksekusi itu sendiri. Claude Code tidak pernah mendapat SSH_AUTH_SOCK, GH_TOKEN, GITHUB_TOKEN, NPM_TOKEN, AWS_*, atau ANTHROPIC_*. Git milik agen tidak melihat konfigurasi git global maupun sistem.

Yang diizinkan dan ditolak oleh sandbox shell:

  • Baca ditolak: folder proyek lain (termasuk eksekusi yang berjalan bersamaan), file milik runner sendiri, dan file serta folder kredensial Anda (kunci SSH, login cloud, login registri paket, kredensial git).
  • Tulis diizinkan: hanya di folder eksekusi dan di folder cache paket proyek yang berada di sampingnya. .git/hooks dan .git/config milik eksekusi hanya bisa dibaca.
  • Jaringan diizinkan: GitHub, npm, Notiamo, situs WordPress (untuk eksekusi WordPress), dan host yang Anda tambahkan di Host tambahan yang boleh dijangkau agen pada kartu Runner. Selebihnya ditolak.

Agen tidak pernah melakukan push dan tidak memegang kredensial. Runner sendiri yang mem-push cabang eksekusi setelah agen selesai bekerja.

Saat eksekusi selesai, runner menghentikan setiap proses yang ditinggalkan agen, misalnya server pengembangan.

Keychain di macOS

Sandbox macOS tidak menutup keychain sepenuhnya. Jadi jangan simpan login GitHub di keychain pengguna yang menjalankan runner (init memberi peringatan jika menemukannya). Pengaturan paling aman adalah pengguna macOS tersendiri dengan keychain sendiri.

Windows

Windows biasa tidak punya sandbox shell. Teks dalam komentar lalu dapat membuat sebuah eksekusi menjalankan perintah apa pun atas nama Anda. Jalankan runner di dalam WSL2. Di Windows biasa, runner tidak mau mulai kecuali Anda menambahkan "allowUnsandboxed": true ke config.json miliknya; lakukan itu hanya di mesin yang tidak menyimpan hal lain.

Beberapa eksekusi sekaligus

Pada kartu Runner Anda mengatur Proses bersamaan: 1 sampai 3. Setiap eksekusi memakai paket Claude Anda, jadi jaga jumlahnya sesuai kapasitas paket. Satu proyek tidak pernah berjalan dua kali sekaligus: eksekusi kedua pada proyek yang sama menunggu yang pertama.

Setiap eksekusi yang berjalan bersamaan punya folder slot sendiri. Sandbox sebuah eksekusi tidak bisa membaca slot lainnya.

Runner untuk satu klien

Saat membuat runner, Anda bisa membatasinya pada satu ruang kerja di Berjalan untuk. Runner itu lalu hanya mengambil eksekusi klien tersebut. Untuk menyiapkannya di komputer klien: pasang Claude Code di sana, jalankan npx @notiamo/runner init, dan tempel token runner. Login Claude di komputer itu yang membayar eksekusinya, jadi masuklah dengan akun yang harus membayar.

Perintah penyiapan dan pengujian

Hasil kloning yang bersih belum punya paket terpasang. Beri tahu agen cara memasangnya dan cara menguji. Buka pengaturan agen proyek dan isi Perintah penyiapan dan Perintah pengujian, masing-masing satu baris.

  • Agen menjalankan perintah penyiapan satu kali, sebelum perubahan pertamanya. Contoh: pnpm install --frozen-lockfile.
  • Agen menjalankan perintah pengujian sebelum setiap commit. Perubahan yang gagal lolos diperbaiki atau dibatalkan. Contoh: pnpm typecheck && pnpm lint.
  • Agen menjalankan keduanya sendiri, di sandbox yang sama dengan perintahnya yang lain. Registri paket harus termasuk host yang diizinkan. GitHub dan registry.npmjs.org sudah ada secara bawaan. Tambahkan yang lain (PyPI, crates.io, registri privat) di Host tambahan yang boleh dijangkau agen pada kartu Runner.
  • Setiap proyek punya folder cache paket di samping hasil kloningnya. npm, pnpm, Yarn, Corepack, Bun, pip, uv, dan Composer menyimpan cache mereka di sana, karena sandbox menutup tempat-tempat biasa di folder home Anda. Folder itu bertahan di antara eksekusi proyek dan hilang bersama kloningnya. Di Windows biasa folder ini tidak ada.
  • Buat perintah pengujian tetap ringan. Pengujian yang membutuhkan Docker tidak bisa berjalan. Pengujian yang membutuhkan database hanya bisa berjalan jika file env proyek menunjuk ke database yang Anda biarkan menyala (lihat di bawah).

Agen melakukan commit sebagai “Notiamo agent”, satu baris sederhana per butir. Runner mematikan trailer “Co-Authored-By” dan baris “Generated with” milik Claude Code, sehingga repositori tidak menampilkan rekan penulis AI.

Lingkungan untuk proyek Anda sendiri

Eksekusi pada proyek GitHub mendapat hasil kloning yang bersih dan tidak ada yang lain. Untuk proyek perangkat lunak Anda sendiri, pengujian mungkin juga membutuhkan database, penyimpanan file, penangkap email, dan .env. Mesin runner memberikannya kepada eksekusi satu proyek lewat sebuah file biasa:

npx @notiamo/runner env <projectId>

<projectId> adalah bagian terakhir dari alamat halaman proyek di Notiamo. Perintah itu membuat ~/.notiamo-runner/env/<projectId>.env, hanya bisa dibaca oleh Anda, dan menampilkan path-nya. Tulis satu KEY=VALUE per baris. Eksekusi berikutnya dari proyek itu mendapat variabelnya di shell-nya, dan agen diberi tahu namanya, tidak pernah nilainya. Hapus file itu untuk menariknya kembali. File ini tidak pernah meninggalkan mesin: Notiamo tidak tahu file itu ada.

Selama file itu ada, shell eksekusi di macOS juga boleh menjangkau layanan di 127.0.0.1: Postgres Anda, penyimpanan file, server pengembangan. Anda yang menjaganya tetap menyala; agen tidak bisa menjalankannya, dan Docker berada di luar jangkauannya. Di Linux, sandbox punya jaringan sendiri, jadi 127.0.0.1 di sana bukan milik mesin: ikat layanan ke alamat jaringan mesin dan tambahkan host itu di Host tambahan yang boleh dijangkau agen.

Aturan:

  • Hanya nilai pengembangan dan pengujian. Agen menjalankan perintah shell dan dapat membaca setiap variabel. Jangan pernah kunci produksi, jangan pernah kata sandi yang Anda pakai di tempat lain.
  • PATH, HOME, variabel proxy dan sertifikat, NODE_OPTIONS, NODE_TLS_REJECT_UNAUTHORIZED, NOTIAMO_*, GIT_*, CLAUDE_*, dan ANTHROPIC_* diabaikan, dan log menyebutkannya. File ini bisa mengubah apa yang dilihat perintah agen, tetapi tidak pernah mengubah cara Claude Code berbicara dengan Anthropic dan Notiamo.
  • Nilai sepanjang 6 karakter atau lebih disamarkan sebagai [secret] dalam transkrip yang diterima Notiamo. Nilai pendek (1, true) tidak.
  • Biarkan Proses bersamaan di 1 jika proyek-proyek sebuah runner berbagi satu database lewat file env-nya. Dua eksekusi sekaligus akan menjalankan pengujiannya pada database yang sama.

Situs WordPress

Koneksinya ada di kartu Akses situs web milik proyek: kata sandi aplikasi, dan opsional SSH atau FTP. Runner mengingat kunci server SSH pada kunjungan pertama dan menolak server yang kemudian menunjukkan kunci lain. Sebuah eksekusi berjalan seperti ini:

  1. Cadangan sebelum. Dengan SSH, runner mengekspor database dan mengunggahnya ke Notiamo dalam bentuk terkompresi, paling besar 200 MB. Notiamo menyimpannya selama 30 hari. Dengan FTP atau API saja, tidak ada cadangan.
  2. Agen bekerja menurut daftar izin di bawah.
  3. Pemeriksaan situs sesudah. Runner membuka situs dan memeriksa bahwa situs masih menjawab.
  4. Pemulihan saat gagal. Jika pemeriksaan gagal, runner memulihkan database.

Yang boleh dijalankan agen dengan wp-cli, per kelompok (diatur di proyek):

  • Konten: post *, term *, menu *, media import, option get, option update.
  • Database: search-replace (hanya teks lama dan teks baru; perintah ini tidak pernah menyentuh tabel pengguna atau tabel opsi), cache flush, rewrite flush, transient delete.
  • Plugin dan tema: plugin dan theme dengan list, activate, deactivate, update.
  • Informasi: core version, site list, db size.
  • File: tidak ada perintah wp-cli; agen memakai alat filenya. Alat itu menulis gaya, skrip, dan file lain yang tidak dijalankan server.
  • File PHP (mati secara default): alat file juga boleh menulis PHP. File PHP adalah kode yang berjalan di server Anda, dan eksekusi WordPress tidak punya langkah persetujuan: perubahan langsung aktif. Nyalakan hanya untuk situs yang semua penulis komentarnya Anda percayai.
  • Tidak pernah, kecuali Anda memilih “Izinkan semuanya”: eval, eval-file, shell, user *, db query|import|reset|drop|export, plugin install, theme install, core update|download.

Apa disimpan di mana

Semuanya ada di ~/.notiamo-runner.

Path Isinya
config.json Alamat Notiamo, nama runner, dan token runner. Hanya bisa dibaca oleh Anda.
claude/ Folder konfigurasi Claude Code untuk runner: login dan sesinya.
projects/ Salinan kerja proyek Anda, satu folder per proyek di setiap slot. Proyek yang tidak dipakai selama jumlah hari yang diatur di kartu Runner dihapus; eksekusi berikutnya mengkloningnya lagi.
git/ Salinan repositori Anda milik runner sendiri. Agen tidak bisa membaca maupun menulis folder ini.
env/ File env yang Anda buat, satu per proyek.
runs/ Pengaturan Claude Code untuk setiap eksekusi yang sedang berjalan. Tanpa rahasia. Dihapus saat eksekusi selesai.
runner.log Apa yang dilakukan runner, tanpa rahasia.
state.json Id eksekusi yang sedang berjalan. Setelah restart, masing-masing dilaporkan ke Notiamo sebagai gagal.

Rahasia sebuah eksekusi (kata sandi WordPress, token milik eksekusi itu sendiri) datang dari Notiamo bersama eksekusinya dan hanya hidup di memori. Agen mendapatkannya sebagai variabel lingkungan, tidak pernah dalam file. Apa yang dicetak agen dibersihkan dari rahasia itu sebelum transkrip diunggah.

Runner tidak pernah memakai kredensial git milik mesin. Setiap eksekusi mendapat dari Notiamo token GitHub yang berlaku satu jam dan hanya untuk repositori eksekusi itu. Runner menyimpannya di memori dan memakainya untuk fetch dan push-nya sendiri. Notiamo yang membuka dan menggabungkan pull request.

Menghentikan runner

Pada kartu Runner, tekan Nonaktifkan untuk menjeda sebuah runner, atau Hapus untuk menghapusnya. Token runner yang dihapus langsung berhenti berfungsi.