QuickTerminal - Panduan

Memulai

1. Luncurkan aplikasi — Anda tiba di layar utama dengan sesi tersimpan dan tombol untuk memulai koneksi baru.
2. Mulai shell lokal — ketuk Local Shell untuk segera membuka sesi terminal di perangkat Anda.
3. Buat sesi jarak jauh — ketuk New Session, pilih protokol (SSH, Telnet, Mosh, Serial, AWS SSM, atau GCP IAP), dan masukkan detail koneksi.
4. Simpan sesi — beri nama dan tetapkan ke grup. Sambungkan kembali dengan satu ketukan kapan saja.
5. Jelajahi Command Palette — tekan Ctrl + Shift + P untuk mengakses setiap tindakan dari satu daftar yang dapat dicari.

Gambaran Antarmuka

Sidebar

Sidebar yang dapat diciutkan mengorganisir ruang kerja Anda:

• Sesi — semua sesi tersimpan yang dikelompokkan berdasarkan proyek atau lingkungan
• SFTP — buka browser file grafis untuk koneksi yang aktif
• Snippets — pustaka perintah tersimpan Anda
• AI Agent — luncurkan panel asisten AI
• Pengaturan / Bantuan — di bagian bawah sidebar

Area Terminal

Ruang kerja tengah menampilkan:

• Terminal aktif dengan input dan output lengkap
• Tab bar untuk beralih antara beberapa sesi yang terbuka
• Status bar di bagian bawah yang menampilkan status koneksi, protokol, dan timer sesi
• Tampilan split-pane opsional untuk menjalankan beberapa terminal berdampingan

Command Palette

Tekan Ctrl + Shift + P untuk membuka Command Palette. Ketik untuk memfilter tindakan, lalu tekan Enter untuk mengeksekusi. Setiap fitur di QuickTerminal dapat diakses melalui palette.

Shell Lokal

QuickTerminal menyertakan shell lokal yang sepenuhnya terintegrasi untuk menjalankan perintah di perangkat Anda sendiri.

• Deteksi shell — secara otomatis mendeteksi dan menggunakan shell default Anda (bash, zsh, fish, PowerShell)
• Pelacakan direktori kerja — status bar selalu menampilkan direktori Anda saat ini
• Riwayat perintah — riwayat persisten lintas sesi, dapat dicari dengan Ctrl + R
• Variabel lingkungan — mewarisi profil dan lingkungan shell Anda secara otomatis

$ echo "Welcome to QuickTerminal"
Welcome to QuickTerminal
$ ssh user@server.example.com
# Or create a saved session for one-tap reconnection

Koneksi SSH

SSH adalah protokol utama untuk akses jarak jauh yang aman. QuickTerminal mendukung semua fitur SSH modern.

Autentikasi

• Password — masukkan kredensial saat koneksi atau simpan dengan aman di sesi
• Berbasis kunci — gunakan kunci RSA, Ed25519, atau ECDSA. Impor dari file atau buat pasangan kunci baru
• Agent forwarding — teruskan SSH agent lokal Anda ke host jarak jauh untuk akses multi-hop yang mulus
• Keyboard-interactive — mendukung autentikasi dua faktor dan prompt challenge-response

Port Forwarding

• Local forwarding — tunnelkan port jarak jauh ke mesin lokal Anda
• Remote forwarding — ekspos layanan lokal ke host jarak jauh
• Dynamic forwarding — buat proxy SOCKS melalui tunnel SSH

Konfigurasi Sesi

# Example session fields
Host:       server.example.com
Port:       22
Username:   deploy
Auth:       Key (Ed25519)
Forwarding: Local 8080 → remote 80

Protokol Lainnya

Telnet

Konfigurasikan host dan port. Koneksi Telnet tidak dienkripsi; gunakan hanya pada jaringan tepercaya atau untuk peralatan yang memerlukannya.

Mosh

Memerlukan server Mosh yang terpasang di host jarak jauh. QuickTerminal menangani handshake SSH awal dan setup sesi UDP secara otomatis. Ideal untuk kondisi jaringan mobile atau tidak stabil.

Serial

Pilih port serial, baud rate (9600, 19200, 38400, 57600, 115200, dsb.), bit data, bit stop, parity, dan flow control. Terminal menampilkan data serial mentah dan mendukung pengiriman sinyal break.

AWS SSM

Autentikasi dengan kredensial AWS atau peran IAM Anda. Pilih instance target berdasarkan ID atau nama. QuickTerminal memanggil plugin sesi SSM untuk membangun koneksi.

GCP IAP

Autentikasi dengan akun Google Cloud Anda. Pilih project, zone, dan instance. QuickTerminal melakukan tunnel melalui IAP menggunakan izin IAM Anda.

Browser SFTP

Browser SFTP bawaan menyediakan manajer file grafis untuk setiap host yang terhubung melalui SSH.

• Telusuri direktori — navigasikan filesystem jarak jauh dengan tampilan tree dan list yang familier
• Upload file — seret dan lepas file dari mesin lokal Anda atau gunakan tombol upload
• Download file — pilih file dan unduh ke direktori lokal
• Edit jarak jauh — buka file teks di editor bawaan dan simpan langsung ke server
• Izin — lihat dan modifikasi izin file, kepemilikan, dan timestamp
• Cari — temukan file berdasarkan nama dalam tree direktori saat ini

Agen AI

Agen AI QuickTerminal membantu Anda dalam penyusunan perintah, analisis output, dan otomatisasi tugas.

Apa yang dapat dilakukan Agen AI

• Pembuatan perintah — jelaskan yang Anda inginkan dalam bahasa biasa dan agen akan menyarankan perintah yang tepat
• Penjelasan output — tempel atau pipe output terminal ke agen untuk penjabaran yang mudah dibaca
• Diagnosis error — bagikan pesan error dan dapatkan perbaikan yang disarankan beserta penjelasannya
• Otomasi multi-langkah — jelaskan alur kerja dan agen akan menghasilkan urutan perintah
• Pembuatan skrip — minta agen untuk membuat shell script untuk tugas yang berulang

Menggunakan Panel Agen

1. Buka panel AI Agent dari sidebar atau tekan Ctrl + Shift + A.
2. Ketik permintaan Anda dalam bahasa alami.
3. Tinjau perintah atau penjelasan yang disarankan.
4. Klik Insert untuk menempelkan perintah ke terminal Anda, atau Copy untuk menyalin ke clipboard.

Snippet

Snippet memungkinkan Anda menyimpan, mengorganisir, dan memasukkan dengan cepat perintah yang sering digunakan.

Membuat Snippet

1. Buka panel Snippets dari sidebar.
2. Ketuk New Snippet.
3. Masukkan perintah, nama, dan deskripsi opsional.
4. Gunakan sintaks ${variable_name} untuk template berparameter.
5. Simpan ke pustaka snippet Anda.

Variabel Template

# Snippet with variables
$ ssh ${user}@${host} -p ${port:22}
# ${port:22} uses 22 as default if not specified

Saat Anda memasukkan snippet berparameter, QuickTerminal meminta Anda mengisi setiap variabel sebelum memasukkan perintah akhir.

Mengorganisir Snippet

• Tetapkan tag untuk mengelompokkan snippet terkait (mis. deployment, monitoring, database)
• Cari snippet berdasarkan nama, konten, atau tag
• Pin snippet yang paling sering digunakan untuk akses cepat di bagian atas daftar

Command Palette

Command Palette adalah peluncur tindakan universal yang dapat diakses dari mana saja di QuickTerminal.

• Tekan Ctrl + Shift + P untuk membuka
• Ketik untuk memfilter tindakan — fuzzy matching dengan cepat menemukan yang Anda butuhkan
• Tindakan mencakup: membuat sesi, membuka SFTP, mengubah pengaturan, menjalankan snippet, dan lainnya
• Tindakan yang baru digunakan muncul di bagian atas untuk akses berulang yang cepat

# Example palette actions
New SSH Session
Open SFTP Browser
Insert Snippet...
Toggle Split Pane
Open AI Agent
Manage Execution Policies

Execution Policies

Execution Policies memungkinkan Anda menentukan aturan keselamatan yang melindungi dari perintah tak sengaja atau destruktif.

Tipe Kebijakan

Mengkonfigurasi Kebijakan

1. Buka Settings > Execution Policies.
2. Ketuk New Policy.
3. Tentukan pattern — prefiks perintah, regex, atau kata kunci untuk dicocokkan.
4. Pilih tindakan (block, confirm, sandbox, atau log).
5. Atur cakupan — terapkan ke semua sesi, grup tertentu, atau sesi individu.

Pengaturan

Tampilan

• Tema — mode Terang dan Gelap dengan deteksi preferensi sistem
• Keluarga font — pilih font monospace pilihan Anda untuk terminal
• Ukuran font — ukuran teks terminal yang dapat disesuaikan
• Skema warna — pilih dari palet warna terminal bawaan atau impor skema kustom

Terminal

• Buffer scrollback — konfigurasikan berapa banyak baris riwayat yang disimpan di memori
• Gaya kursor — blok, garis bawah, atau bar
• Perilaku bell — kilatan visual, suara sistem, atau senyap
• Salin saat pilih — otomatis menyalin teks yang disorot ke clipboard

Koneksi

• Port SSH default — atur port default kustom untuk sesi SSH baru
• Interval Keep-alive — kirim paket secara berkala untuk mencegah timeout koneksi
• Sambung ulang saat terputus — secara otomatis mencoba memulihkan koneksi yang terputus

Execution Policies

• Kelola aturan block, confirm, sandbox, dan log
• Aktifkan atau nonaktifkan kebijakan per grup sesi

Pintasan Keyboard

Tips & Trik

Pemecahan Masalah

Privasi

• QuickTerminal tidak memerlukan akun atau login.
• Tidak ada data penggunaan, analytics, atau telemetri yang dikumpulkan.
• Semua kredensial dienkripsi menggunakan keystore native platform.
• Agen AI berjalan sepenuhnya di perangkat — tidak ada data yang dikirim ke server eksternal.
• Riwayat sesi dan snippet disimpan secara lokal di perangkat Anda.
• Transfer SFTP langsung antara perangkat Anda dan host jarak jauh.
• Aplikasi bekerja sepenuhnya offline untuk shell lokal dan koneksi serial.