Memulai dengan MXterm Pro
Halaman ini memandu Anda dari unduhan sampai workspace yang berjalan: memasang aplikasi, mengisi composer workspace, dan mengenal tab, jendela serta sidebar. Baca bagian Bypass Mode sebelum menjalankan agent.
Pemasangan
Unduh MXterm Pro dari halaman unduhan. Untuk Mac, Anda mendapat DMG yang berjalan native di Apple silicon maupun Intel, dan membutuhkan macOS 10.15 atau lebih baru. Untuk PC Windows, halaman unduhan menyediakan installer untuk Windows 10 atau 11 di x64; tidak ada build ARM64. Sisa halaman ini diperiksa pada aplikasi macOS, dan bagian yang diketahui berbeda di Windows akan disebutkan.
Setelah Anda mengklik tombol unduh di situs, popup Install in three steps menampilkan langkah-langkah untuk file yang Anda pilih. Langkahnya sama dengan yang di bawah ini.
- Buka DMG yang Anda unduh.
- Seret MXterm Pro ke Aplikasi.
- Buka MXterm Pro dari folder Aplikasi.
- Jika macOS menanyakan apakah Anda ingin membuka aplikasi yang diunduh dari internet, pilih Buka.
Di macOS, aplikasi ini ditandatangani dengan Apple Developer ID dan dinotarisasi oleh Apple.
Di Windows:
- Jalankan file
.exeyang Anda unduh. - Jika Windows SmartScreen menampilkan Windows melindungi PC Anda (Windows protected your PC), klik Informasi selengkapnya (More info), lalu Tetap jalankan (Run anyway). Installer belum ditandatangani (code-signed), sehingga Windows menampilkan penerbitnya sebagai tidak dikenal (Unknown).
- Ikuti langkah-langkah installer.
Peluncuran pertama
Saat aplikasi pertama kali dibuka, muncul tur enam slide berjudul Selamat datang di MXterm Pro (Welcome to MXterm Pro). Klik Berikutnya (Next) untuk melanjutkan atau Lewati Tur (Skip Tour) untuk menutupnya. Menu bahasa di header tur mencantumkan semua bahasa yang tersedia di aplikasi, dan memilih salah satunya mengganti bahasa tur dan aplikasi. Tur terbuka sendiri satu kali dan tidak muncul lagi setelah Anda menutupnya; Anda bisa memutarnya ulang dari menu logo, di bawah Tur selamat datang (Welcome tour).
Di belakang tur, jendela hanya memiliki satu tab, New Tab, yang menampilkan composer workspace. Antarmuka memakai bahasa pertama di daftar bahasa sistem Anda yang tersedia di aplikasi, atau bahasa Inggris jika tidak ada yang tersedia; bahasa yang pernah Anda pilih tetap dipakai. Aplikasi menyediakan English, Tiếng Việt, 简体中文, 日本語, 한국어, Español, Français, Türkçe, Bahasa Indonesia, Português (Brasil) dan Deutsch. Anda bisa mengubahnya nanti di Pengaturan, tempat setiap bahasa ditulis dengan namanya sendiri.
Membuat workspace
Workspace adalah tab berisi grid pane terminal yang semuanya dimulai di satu folder. Tidak ada yang berjalan sampai Anda membuatnya.
- Di bawah Folder kerja (Working folder), ketik path atau klik Telusuri (Browse). Isian ini dimulai dari folder home Anda, dan folder yang pernah Anda pakai tercantum di bawah Terbaru (Recent).
- Di bawah Berapa terminal? (How many terminals?), pilih 1, 2, 4, 6, 8, 9, 10, 12, 16 atau 20. Pratinjau di bawahnya menunjukkan grid yang akan Anda dapat. Layout beralih antara Horizontal (sebuah grid) dan Vertikal (satu baris kolom tinggi, pane berdampingan). Vertikal menawarkan 1 sampai 6 pane, dan jumlah yang tidak ditawarkan turun ke jumlah terbesar di bawahnya.
- Di bawah Agen AI (AI agents), gunakan tombol − dan + untuk menentukan berapa pane yang menjalankan tiap agent. Daftar dibuka dengan Claude Code, Codex, Grok dan Gemini CLI, lalu baris Terminal (Plain Shell), lalu OMP; agent lainnya menyusul, yang sudah Anda pasang di urutan pertama. Agent yang CLI-nya tidak ditemukan aplikasi ditandai Belum terpasang dan punya tombol Pasang, yang membuka panduan pemasangan agent itu; MXterm Pro tidak pernah menjalankan pemasangan untuk Anda. Untuk Cursor Agent, CLI-nya adalah
cursor-agent. Selama aplikasi masih memeriksa, atau jika pemeriksaan gagal (tautan Coba lagi muncul), tidak ada agent yang bisa dicentang dan setiap pane adalah shell biasa. - Pane yang tidak Anda tetapkan menjalankan shell biasa. Baris Terminal (Plain Shell) memungkinkan Anda memilih shell itu dan menentukan jumlah pane biasa secara eksplisit.
- Periksa tiga opsi di bawah pratinjau (lihat tabel di bawah), lalu klik Buat ruang kerja (Create workspace) atau tekan
Cmd+Enter(Ctrl+Enterdi Windows).
Composer selalu menawarkan Claude Code, Codex, OpenCode, GitHub Copilot, Qwen Code, Amp, Gemini CLI, Cursor Agent, Antigravity, OMP (Oh My Pi) dan Grok. Agent lain, seperti Aider, Goose, Kimi Code dan Devin, baru muncul setelah MXterm Pro menemukan CLI-nya di komputer Anda. Composer dimulai dengan 2 terminal dan hanya menaruh agent yang sudah Anda pasang di dalamnya. Dengan Claude Code dan Codex terpasang, composer mengusulkan satu untuk masing-masing. Jika tidak, dua agent terpasang pertama dalam daftar membagi pane, separuhnya (dibulatkan ke atas) untuk yang pertama; jika hanya satu agent terpasang, agent itu mendapat separuh dan sisanya shell biasa, dan jika tidak ada satu pun, setiap pane adalah shell biasa. Saat Anda mengklik Buat ruang kerja, composer mengingat pilihan itu (agent, terminal biasa, layout, dan jumlah pane) dan memulai dari situ lain kali, disesuaikan dengan jumlah pane yang Anda pilih; agent yang diingat tetapi sudah tidak terpasang menjadi shell biasa. Periksa baris Agen AI sebelum Anda membuat workspace.
| Opsi | Default | Fungsinya |
|---|---|---|
| Aktifkan Mode Bypass (setujui otomatis izin CLI) | Nonaktif | Menjalankan agent yang didukung dengan flag untuk melewati persetujuan. Lihat Bypass Mode. |
| Isolasi fitur di git worktree | Nonaktif | Setiap pane agent dimulai di git worktree dan branch-nya sendiri, yang dibuat di bawah .worktrees/ di folder tersebut. .worktrees/ ditambahkan ke .gitignore folder itu. |
| Lanjutkan sesi sebelumnya (--resume / codex resume) | Nonaktif | Menjalankan Claude Code, Gemini CLI, OMP dan Grok dengan --resume dan Codex dengan codex resume, yaitu cara tiap CLI membuka kembali sesi lama. Grok membuka kembali sesi terbarunya di folder itu. Agent lainnya dimulai seperti biasa. |
Jika folder sudah memiliki sesi agent, daftar Lanjutkan sesi (Resume sessions) muncul di bawah kolom folder. Centang sebuah sesi untuk membukanya kembali di pane-nya sendiri. Satu workspace menampung paling banyak 20 pane, jadi Anda tidak bisa mencentang lebih banyak setelah mencapai 20. Sesi yang Anda centang lebih diutamakan daripada opsi lanjutkan untuk pane tersebut.
Jika folder adalah repo git yang belum punya commit, Isolasi fitur di git worktree lebih dulu me-commit file .gitkeep kosong sebagai Initial commit, karena worktree butuh sebuah commit sebagai titik awal. Tidak ada hal lain di folder yang di-stage atau di-commit.
Composer memiliki dua kolom, yaitu folder kerja di sebelah kiri dan terminal di sebelah kanan, selama lebar tab mencukupi. Jika tidak mencukupi, misalnya saat sidebar dan panel kanan sama-sama terbuka, kedua kolom ditumpuk menjadi satu kolom.
Informasi lebih lanjut tentang agent dan worktree ada di Coding agent dan Control Room (sebelumnya War Room).
Bypass Mode nonaktif secara default
Bypass Mode menyuruh agent melewati prompt persetujuan, sehingga mereka menjalankan perintah dan mengubah file tanpa bertanya dulu kepada Anda. Fitur ini nonaktif kecuali Anda mengaktifkannya: dari awal, agent Anda berhenti dan bertanya.
Jika Anda memakai versi yang lebih lama, composer menampilkan pemberitahuan sampai Anda menutupnya atau mengubah kotak centangnya: Mode Bypass kini nonaktif secara default. Agen akan bertanya sebelum menjalankan perintah atau mengedit berkas. Aktifkan kembali dengan sakelar di bawah. Jika Anda sudah mencentang atau menghapus centang kotak itu sendiri, pilihan Anda tetap dipakai.
Untuk mengaktifkannya:
- Buka composer: tekan
Cmd+T(Ctrl+Tdi Windows), atau klik + di ujung strip tab lalu pilih Tab baru. - Centang Aktifkan Mode Bypass (setujui otomatis izin CLI).
--dangerously-skip-permissions, Codex dengan --dangerously-bypass-approvals-and-sandbox, Gemini CLI dan Qwen Code dengan --yolo, serta Grok dengan --always-approve. Composer menyebutkannya di bawah kotak centang: Agen akan menjalankan perintah dan mengedit berkas tanpa bertanya. Aktifkan hanya di folder yang risikonya Anda terima.Bypass Mode menambahkan flag lewati persetujuan milik masing-masing agent yang didukung, dan MXterm Pro mengenalnya untuk 14 agent. Agent lainnya, termasuk OpenCode, GitHub Copilot, Amp, Cursor Agent, Antigravity dan OMP, dijalankan dengan perintah normalnya baik Bypass Mode aktif maupun tidak.
Pilihan ini tersimpan begitu Anda mengubahnya. Setiap pane agent yang dimulai setelah itu mengikutinya, termasuk pane yang dibuka kembali saat Anda menjalankan aplikasi berikutnya. Kotak di composer adalah sakelar untuk bypass berbasis flag. Goose tidak punya flag, jadi mode otomatisnya berupa environment variable yang hanya ditawarkan di Pengaturan.
Free dan Pro
Semua yang ada di halaman ini berfungsi di Free. Free tidak membatasi jumlah pane: Anda bisa membuka pane sebanyak yang Anda mau di semua tab dan jendela. Selain pane, Free secara default menghitung enam hal, dan lisensi Pro menghapus semuanya. Pro juga menambahkan Perangkat Saya (buka Mac Anda yang lain yang sudah masuk tanpa kode atau kata sandi) dan kata sandi akses Tetap (tidak kedaluwarsa).
| Batas | Free | Pro |
|---|---|---|
| Host SSH tersimpan | 5 | Tanpa batas |
| Control Room berisi anggota pada saat yang sama | 1 | Tanpa batas |
| Terminal dalam satu Control Room | 2 | Tanpa batas |
| Mesin tersimpan | 1 | Tanpa batas |
| Komputer lain yang dipasangkan untuk mengendalikan komputer ini | 1 | Tanpa batas |
| Pane yang dibagikan sekaligus untuk kendali jarak jauh | 5 | Tanpa batas |
Ini adalah angka default. mxterm.net dapat mengubahnya untuk Free dalam rentang yang tetap, dan perubahan bisa kedaluwarsa, setelah itu angka default berlaku lagi. Batas diperiksa saat Anda menambahkan sesuatu: menurunkannya tidak pernah menutup apa yang sudah terbuka atau tersimpan, dan menambahkan mesin kedua di Free membuka dialog upgrade, sementara mesin yang sudah ada tetap ada. Hal yang sama berlaku untuk Control Room kedua yang berisi anggota: room tanpa anggota tidak dihitung, dan room yang sudah Anda miliki tetap ada. Aplikasi sendiri yang memberlakukan batas Control Room dan mesin. Aplikasi MXterm di ponsel (iPhone, iPad) tidak dihitung dalam batas 1 komputer lain yang dapat mengontrol Mac ini. Hanya komputer lain yang menjalankan MXterm yang dihitung; browser tidak. Kedua batas kendali jarak jauh hanya menolak sesuatu yang baru: komputer yang sudah dipasangkan dan pane yang sudah dibagikan tetap seperti semula.
Akses jarak jauh punya satu batas Pro lagi: Free dapat mengaktifkan kata sandi akses yang berlaku hingga 8 jam (Sementara), sedangkan kata sandi Tetap, atau Sementara yang lebih dari 8 jam (hingga 7 hari), memerlukan Pro. Kata sandi minimal 6 karakter. Lihat Pengaturan.
Menelusuri, mengedit, mengunggah dan mengunduh file lewat SFTP itu gratis, dan Token Meter juga.
Saat Anda mencapai batas, sebuah dialog menyebutkan batas itu dan menawarkan Dapatkan MXterm Pro, Masukkan Kunci Lisensi atau Nanti saja. Paket ada di Harga; cara mengaktifkan kunci dijelaskan di Pengaturan.
Menutup jendela terakhir berarti keluar dari aplikasi
Menutup satu-satunya jendela MXterm Pro akan keluar dari aplikasi, di semua platform. Aplikasi tidak tetap berjalan di latar belakang: setiap terminal dan agent di setiap tab dihentikan. Keluar dari aplikasi menghentikan setiap koneksi yang sedang berjalan. MXterm Pro dirancang untuk menyimpan status berbagi Anda dan memulihkannya saat aplikasi dibuka lagi, setelah pane yang sama berjalan kembali; berbagi yang tidak dapat diverifikasi dibuang, tidak pernah diperluas.
Jika Anda membuka jendela kedua, menutup salah satunya tidak berarti menutup aplikasi. Jendela yang masih berisi terminal bertanya Tutup jendela ini? lebih dulu, dan menawarkan untuk memindahkan tab-nya ke jendela lain alih-alih mengakhirinya. Hanya penutupan jendela terakhir yang menutup aplikasi.
Selama aplikasi berjalan, ikonnya di menu bar (system tray di Windows) memunculkan jendela ke depan saat diklik, dan menunya berisi Show MXterm Pro, Merge All Windows, Check for Updates… dan Quit.
Saat Anda membuka aplikasi lagi, tab workspace Anda kembali bersama tata letak pane-nya, dan setiap pane dimulai lagi di foldernya. Pane Claude Code membuka kembali percakapannya sendiri lewat id jika aplikasi mengingatnya, dan memulai percakapan baru jika tidak. Pane Gemini CLI, OMP dan Grok dijalankan dengan --resume dan pane Codex dengan codex resume, sehingga Anda bisa melanjutkan percakapan sebelumnya; pane lain dimulai dari awal. Tab yang masih berada di composer tidak dipulihkan.
Aplikasi juga mengingat, kira-kira setiap 3 detik, apa yang dijalankan tiap pane. Untuk Claude Code dan OMP, aplikasi menyimpan percakapan yang sedang terbuka, sehingga pane membuka percakapan itu dan bukan pemilih sesi atau yang terbaru di folder. Jika percakapan itu sudah tidak ada, Claude Code, OMP dan Grok mencoba lagi dengan --resume saja di sebagian besar shell, alih-alih berhenti di prompt kosong. Jika Anda menjalankan sendiri sebuah agent di pane terminal biasa, pane itu kembali menjalankan agent tersebut, dilanjutkan dengan cara yang sama, tetapi tanpa flag Bypass Mode-nya. Di Windows aplikasi tidak membaca apa yang dijalankan sebuah pane, jadi fitur mengingat ini tidak berlaku di sana.