# Box untuk agen Anda

Sumber: https://kilat.host/id/docs/boxes

Box adalah komputer yang dipakai agen Anda untuk menulis kode, menjalankan program, dan menjelajah web. Box punya file dan browser sendiri, dan tidur saat tidak ada yang memakainya.

## Apa itu box

- Setiap box adalah mesin Linux Debian dengan **4 vCPU, memori 8 GB, dan disk 20 GB**.
- Box masih beta. Satu workspace bisa punya paling banyak **2 box**, dan box butuh paket yang aktif.
- Box pertama dibuat saat agen yang memakai box pertama kali membutuhkannya. Anda bisa menambah satu lagi di halaman **Box** di sidebar dasbor. Jika Box tidak ada di sana, berarti belum aktif untuk workspace Anda.
- File di `/work` dan folder home Anda tetap ada saat box tidur. Program yang Anda pasang juga tetap ada.
- Menghapus box menghapus filenya dan semua akun yang masuk di browsernya. Anda mengetik nama box untuk konfirmasi, dan ini tidak bisa dibatalkan.

## Tidur dan bangun

- Box tidur sendiri setelah 30 menit tanpa perintah dan hampir tanpa pemakaian CPU (di bawah 1% dari satu vCPU). Box tetap aktif selama ada proses latar belakang yang berjalan, atau selama desktop atau terminal terbuka.
- Perintah yang dikirim ke box yang tidur akan membangunkannya. Agen lalu mengirim perintah itu lagi.
- Untuk tidur sekarang, pilih **Tidurkan** di halaman box, atau minta agen. Box tidak bisa tidur selama ada proses yang berjalan.
- Box yang tidur tidak dikenai biaya.

## Biayanya

Box dibayar sesuai pemakaian. Box bukan bagian dari paket Anda.

| Apa | Harga |
| --- | --- |
| Waktu aktif | $0,01 per jam, tetap |
| Waktu box | $0,02 per jam waktu box, untuk kerja programnya |
| Disk | Gratis selama beta |

Waktu box adalah seberapa keras box bekerja. Satu jam waktu box sama dengan satu vCPU yang terpakai penuh selama satu jam, jadi seluruh 4 vCPU yang terpakai penuh selama satu jam memakai 4 jam waktu box.

Contohnya:

- Satu jam aktif dan diam: $0,01.
- Satu jam dengan satu vCPU penuh terpakai: $0,01 + $0,02 = $0,03.
- Satu jam dengan seluruh 4 vCPU penuh terpakai: $0,01 + 4 × $0,02 = $0,09.

Waktu box ditagih setelah setiap jam berakhir. Tagihan memakai Kredit Anda dulu, lalu Saldo. Saldo hanya membayar box bila bayar sesuai pemakaian menyala, sampai batas bulanannya. Workspace dengan paket kartu membayar harga dolar AS yang tercantum, dari Kredit.

### Batas bulanan

Setiap box bisa memakai **100 jam waktu box per bulan**, yaitu $2 dengan $0,02 per jam. Hitungannya mulai lagi pada tanggal 1 setiap bulan.

Saat box mencapai batasnya, atau saat tidak ada yang bisa membayarnya, box menolak perintah baru, penulisan file, dan permintaan bangun. Box tidur setelah prosesnya selesai. Proses yang masih berjalan setelah 10 menit dihentikan. Pesannya menjelaskan sebabnya dan kapan batas diatur ulang. File Anda tetap ada.

## Cara agen memakai box

- Agen menjangkau box lewat Kilat MCP, hanya bila saklar **Pakai box** menyala. Saklarnya ada di tab **Alat** agen.
- Agen Coder menyalakan Pakai box. Agen lain mematikannya sampai Anda menyalakannya.
- Agen yang melayani pelanggan tidak pernah menjangkau box.
- Agen yang membuat box adalah agen utamanya. Secara default, semua agen lain yang memakai box di workspace juga bisa memakainya.
- Satu perintah berjalan sampai 90 detik. Untuk pekerjaan yang lebih lama, agen memulai proses latar belakang dan memeriksanya nanti.
- Agen membaca atau menulis sampai 180 KiB file per panggilan. File yang lebih besar dibaca sebagian-sebagian.
- Apa pun yang dikirim kembali box ditandai sebagai data yang tidak tepercaya, jadi agen tidak menuruti perintah darinya.

### Alat box

Alat ini hanya muncul di token otomatis milik agen pemilik, dan hanya bila Pakai box menyala. Lihat [referensi MCP](https://kilat.host/id/docs/mcp#agent-only-tools) untuk alat agen lainnya.

| Alat | Fungsinya |
| --- | --- |
| `box_status` | Menampilkan box: tidur atau aktif, disk, waktu box yang dipakai bulan ini terhadap batasnya, dan proses yang berjalan. Bila ada lebih dari satu box, alat ini mendaftarkannya. |
| `box_exec` | Menjalankan perintah shell di `/work`, sebagai pengguna `agent` dengan sudo. Sampai 90 detik, atau sebagai proses latar belakang. |
| `box_run` | Memeriksa, membaca, atau menghentikan proses latar belakang. |
| `box_files` | Mendaftar, membaca, menulis, atau memeriksa sebuah file. |
| `box_sleep` | Menidurkan box sekarang. File dan program tetap ada. |
| `box_env_list` | Mendaftar variabel lingkungan: nama dan tanggal, tidak pernah nilainya. |
| `box_env_set` | Menambah atau mengganti variabel lingkungan. |
| `box_env_unset` | Menghapus variabel lingkungan. |
| `box_desktop_link` | Memberi tautan ke halaman desktop box, untuk Anda. Tautan hanya terbuka untuk admin yang masuk ke Kilat. Ini bukan tautan masuk. |

## Yang terpasang

- Desktop Xfce dengan Chromium.
- Python 3, Node, Bun, Go, Rust, dan OpenJDK 21.
- `git` dan `gh`.
- Alat coding `omp`, Claude Code, Codex, dan OpenCode. Masuk ke Claude Code, Codex, dan OpenCode sendiri.
- Anda bisa memasang yang lain dengan `apt` dan `sudo`.
- Docker belum tersedia di box.

## Desktop dan terminal

### Desktop

Pilih **Buka desktop** di halaman box untuk melihat layar box di browser Anda. Hanya pemilik workspace atau admin yang bisa membukanya. Box yang tidur dibangunkan dulu, dan filenya tetap seperti semula.

- Satu sesi berlangsung sampai 60 menit dan berakhir setelah 10 menit tanpa input. Desktop yang terbuka membuat box tetap aktif.
- Desktop tidak dikenai biaya tambahan selama beta.
- Bar tombol di atas layar mengirim **Esc**, **Tab**, **Ctrl**, **Alt**, dan **Super**. Ctrl dan Alt tetap tertahan untuk tombol berikutnya.
- **Layar penuh** memenuhi layar Anda. Desktop menyesuaikan diri dengan jendela Anda.

### Tempel dan clipboard

- Tekan **Ctrl+V** (**⌘V** di Mac) untuk menempel dari komputer Anda ke box. Di terminal, tambahkan Shift: **Ctrl+Shift+V**.
- Teks yang Anda salin di box muncul di panel **Clipboard** di bawah layar. Teks itu juga masuk ke clipboard Anda bila browser mengizinkan.
- Jika browser Anda tidak membagikan clipboard-nya, tempel teks Anda di panel lalu pilih **Kirim ke box**.

### Terminal

Halaman box juga punya **Terminal**: shell di `/work`. Sesi berakhir setelah 10 menit tanpa input atau total 60 menit. Terminal yang terbuka membuat box tetap aktif.

## Variabel lingkungan

Variabel lingkungan menyimpan pengaturan dan kunci yang dibutuhkan program Anda. Atur di kartu **Variabel lingkungan** di halaman box, atau minta agen yang memakai box.

- Satu box bisa punya sampai **50 variabel**. Satu nilai bisa sampai **8 KiB**.
- Nama berisi huruf, angka, dan `_`, dan tidak diawali angka. Nama yang dipakai Kilat atau shell tidak diizinkan, seperti `PATH`, `HOME`, `TZ`, dan apa pun yang diawali `KILAT_`.
- Nilai hanya bisa ditulis. Setelah Anda menyimpannya, tidak ada yang bisa melihatnya lagi di Kilat, termasuk Anda. Agen hanya melihat nama dan tanggal.
- Shell baru di box langsung melihat perubahan, tanpa restart. Program yang sudah berjalan tetap memakai nilai lama. Box yang tidur menerima perubahan saat bangun.
- Setiap agen yang memakai box bisa membaca nilainya dari dalam box. Jangan taruh apa pun di sini yang tidak ingin Anda bagikan ke semuanya.
- Untuk rahasia, atur sendiri di halaman box. Nilai yang diatur agen melewati penyedia modelnya.

## Perbarui sistem

Saat sistem yang lebih baru siap, halaman box menampilkan **Pembaruan tersedia**. Pilih **Perbarui sistem** untuk mendapat alat dan perbaikan terbaru.

- **Yang tetap ada:** file Anda di `/work` dan folder home Anda, termasuk akun yang masuk di browser.
- **Yang hilang:** software yang Anda pasang dengan `apt` atau `sudo`. Pasang lagi setelah pembaruan.
- Semua yang berjalan di box berhenti. Jika ada tugas yang berjalan, Kilat bertanya dulu.
- Box tidur setelah pembaruan selesai. Selama seminggu setelahnya, agennya diberi tahu untuk memasang ulang paket apt mereka.

## Tetap aman

- Setiap agen yang memakai box berbagi filenya dan semua akun yang masuk di browsernya.
- Jangan simpan kata sandi, data pembayaran, atau akun pribadi di browser box.
- Variabel lingkungan bisa dibaca oleh setiap agen di box.

## Pertanyaan umum

### Apakah box yang tidur dikenai biaya?

Tidak. Anda membayar waktu aktif dan waktu box, yaitu kerja programnya. Disk gratis selama beta.

### Apa yang terjadi saat box mencapai batas bulanannya?

Box menolak perintah baru, penulisan file, dan permintaan bangun, lalu tidur setelah prosesnya selesai. File Anda tetap ada. Hitungannya mulai lagi pada tanggal 1 setiap bulan.

### Apakah file saya hilang saat box tidur atau diperbarui?

Tidak. File di /work dan folder home Anda tetap ada. Pembaruan hanya menghapus software yang Anda pasang dengan apt atau sudo.

### Bisakah agen yang melayani pelanggan saya memakai box?

Tidak. Hanya agen Anda sendiri dengan Pakai box menyala yang menjangkau box. Agen yang melayani pelanggan tidak pernah.

### Bisakah saya menjalankan Docker di box?

Belum.
