VPS adalah komputer kerja
Project, Codex, preview, database, dan aplikasi yang berjalan berada di VPS.
Panduan untuk pemula
Coding dari mana saja, cukup dengan berbicara.
Comote menghubungkan laptop atau HP Anda ke satu development workspace di VPS. Tulis permintaan dengan kalimat biasa, Codex mengerjakan kodenya, lalu Anda review, commit, push, dan deploy dari satu tempat.
Comote bersifat privat. Link aplikasi production dapat dibuat publik.
HPChat & approve
CVPSCode + database
LaptopWorkspace yang sama
GitHub source of truth untuk code
Gambaran sederhana
Yang berpindah hanya layar Anda, bukan development-nya.
HP dan laptop adalah pengendali
Buka Comote dari perangkat mana saja. Semua perangkat melihat workspace yang sama.
GitHub menyimpan code resmi
Setelah menekan Push, commit tersimpan di GitHub. Database dan secret tidak ikut masuk GitHub.
Aturan praktis:
Code → GitHub
Database & file runtime → VPS
Password & secret → penyimpanan privat VPS
Quick start
Mulai dalam 5 langkah
Ikuti urutan ini saat pertama kali menggunakan Comote.
1
Hubungkan perangkat ke Tailscale
Pasang Tailscale di laptop atau HP, lalu login ke tailnet yang sama. Setelah terhubung, buka:
comote-vps.tailb6b750.ts.net ↗Kenapa? Alamat Comote tidak dibuka ke internet umum. Tailscale menjadi pintu privat menuju VPS.
2
Login ke Comote
Beri nama perangkat, misalnya HP Bob atau Laptop, lalu tekan Send OTP to Ping. Masukkan kode 6 digit dari DM Ping untuk langsung masuk. Jika diperlukan, pilih Use password instead untuk menggunakan password lama.
- OTP berlaku 5 menit dan hanya dapat dipakai sekali.
- Login password yang berhasil mengirim notifikasi keamanan ke Ping.
- Nama perangkat otomatis dicatat pada commit yang dibuat dari UI.
3
Tambahkan project
Tekan + Add. Pilih Import GitHub bila repository sudah ada, atau Create new untuk project kosong.
- Public repository dapat langsung di-import.
- Private repository memerlukan akses GitHub pada VPS.
- Project kosong perlu dihubungkan ke repository GitHub sebelum Push.
https://github.com/username/nama-project.4
Mulai session dan tulis permintaan biasa
Pilih project, tekan + New, lalu tulis apa yang Anda inginkan. Tidak perlu menghafal command terminal. Pilih model pada bagian bawah kotak chat; gunakan Auto bila ragu. Pilihan tersimpan untuk session tersebut dan dapat diganti sebelum mengirim pesan berikutnya.
5
Review hasil sebelum menyimpan
Codex dapat meminta approval sebelum menjalankan tindakan tertentu. Baca alasan atau command-nya, kemudian pilih Allow once bila sesuai. Setelah selesai, periksa daftar file dan diff di panel Changes.
Jangan asal approve. Untuk tindakan menghapus data, mengubah server, atau mengirim sesuatu ke layanan luar, pastikan targetnya benar.
Menyimpan pekerjaan
Workflow code yang aman
Setiap session baru bekerja di task branch terpisah, sehingga dua pekerjaan tidak saling menimpa.
1CodingBerikan instruksi ke Codex
→
2ReviewLihat file dan diff
→
3Run checksLint, typecheck, test, build
→
4Commit taskSimpan checkpoint
→
5Merge mainGabungkan hasil final
→
6Push mainKirim ke GitHub
→
7DeployTerbitkan aplikasi
Project checks & Fix with Codex
Tekan Run pada Project checks. Comote menjalankan script lint, typecheck, test, dan build yang tersedia. Bila ada yang gagal, buka output atau tekan Fix with Codex. Setelah code berubah, hasil lama ditandai agar Anda menjalankannya kembali.
Codebase index: pencarian code otomatis
Comote membuat indeks lokal untuk setiap workspace agar Codex cepat menemukan file, symbol, route, import, schema, dan config yang relevan. Statusnya terlihat di Changes → Codebase index. Indeks diperbarui otomatis saat diperlukan; tekan Refresh index untuk membangun ulang secara manual. File dependency, hasil build, binary, .env, key, credential, dan database dilewati. Indeks tersimpan privat di Comote dan tidak ikut Push ke repository aplikasi.
Commit task
Isi Commit message dengan kalimat singkat seperti feat: tambah halaman produk, lalu tekan Commit with device note.
Commit otomatis mencatat perangkat, VPS, Codex, dan session asal.
Push task vs Push main
Push task branch hanya mengirim cabang pekerjaan untuk backup/review. Push main mengirim versi resmi yang sudah digabungkan ke GitHub.
Merge into main
Lakukan setelah task bersih dan sudah di-commit. Jika ada konflik, Comote berhenti aman; minta Codex membantu menyelesaikannya.
Repository public tetap butuh izin push
Public berarti siapa pun boleh membaca, bukan menulis. Push tetap memerlukan SSH key atau credential GitHub dengan akses ke repository.
Jaga context tetap lega
Lihat indikator Context di bagian atas chat. Hijau berarti masih lega, kuning mulai besar, dan merah sebaiknya segera dirapikan. Pilih Compact current session untuk meringkas percakapan lama tanpa pindah session, branch, atau file.
Lanjut di fresh session
Pilih Continue in fresh session bila ingin percakapan benar-benar baru. Comote membuat summary otomatis, memakai task worktree yang sama, lalu mengarsipkan session lama. Pekerjaan yang belum di-commit tetap berada di tempatnya.
Rapikan session
Tekan tombol ••• pada session. Archive menyembunyikannya tanpa menghapus pekerjaan dan dapat dipulihkan dari daftar Archived. Delete permanently hanya berhasil bila tidak ada file belum di-commit atau commit yang belum di-merge.
Design UI/UX lebih kaya
Codex di Comote memiliki design intelligence global untuk memilih pola layout, warna, tipografi, responsive behavior, accessibility, dan stack-specific UI. Yang masuk repository aplikasi hanya hasil implementasinya—bukan skill atau database referensinya.
Project Notes yang selalu ikut
Buka Settings → Project notes untuk menyimpan tujuan, aturan design, stack, bahasa, atau batasan project. Comote memberikan catatan ini ke Codex pada setiap pesan dan saat pindah ke fresh session. Catatan disimpan privat di Comote, bukan di repository aplikasi.
Kirim screenshot atau file
Tekan + File di kotak chat, pilih maksimal lima gambar, PDF, data, atau file source, lalu kirim prompt. Maksimal 10 MB per file dan 25 MB per session. File menjadi referensi privat; tidak ikut Git atau Push kecuali Anda secara jelas meminta Codex menyalin hasilnya ke project.
Perbaiki preview/deploy dari log
Jika preview atau deploy gagal, buka log lalu tekan Fix preview with Codex atau Fix deploy with Codex. Comote membatasi ukuran log dan menyamarkan pola credential umum sebelum mengirimkannya ke session aktif.
Session panjang
Compact atau pindah ke fresh session?
Klik indikator Context atau tombol ••• di atas chat untuk membuka kedua pilihan.
Hijau · di bawah 70%Masih lega. Lanjutkan pekerjaan seperti biasa.
Kuning · 70–84%Selesaikan milestone kecil, lalu pertimbangkan Compact.
Merah · 85% ke atasCompact sekarang atau pindah ke fresh session.
Pilihan 1
Compact current session
Pilih ini bila topiknya masih sama dan Anda ingin tetap melihat satu percakapan. Comote meminta Codex memadatkan context lama tanpa mengganti session, model, branch, worktree, atau file.
- Tunggu Codex selesai bekerja sampai status kembali Ready.
- Klik Context atau •••.
- Pilih Compact current session dan tunggu proses selesai.
- Lanjutkan dengan kalimat biasa pada chat yang sama.
Pilihan 2
Continue in fresh session
Pilih ini setelah percakapan sangat panjang atau saat memasuki fase kerja baru. Comote membuat AI handoff summary, membuka session baru pada task worktree yang sama, mempertahankan pilihan model, dan mengarsipkan session lama.
- Buat commit checkpoint bila sudah mencapai milestone; ini dianjurkan, tetapi file yang belum di-commit tetap dipertahankan.
- Klik Continue in fresh session.
- Tunggu sampai session baru tampil dan Codex mengakui ringkasan pekerjaan lama.
- Kirim instruksi berikutnya—tidak perlu menjelaskan ulang seluruh project.
Catatan keamanan worktree: session lama dan session baru menunjuk ke file task yang sama. Karena itu Comote tidak mengizinkan keduanya aktif bersamaan. Jika ingin memulihkan session lama, arsipkan atau hapus session lanjutan terlebih dahulu.
Design intelligence
UI/UX bekerja otomatis dari prompt Anda
Anda tidak perlu memasang atau menyalin skill ke project. Saat permintaan menyangkut tampilan, Codex dapat memakai referensi global untuk layout, warna, tipografi, accessibility, responsive behavior, dan framework yang sedang digunakan. Repository aplikasi hanya menyimpan hasil implementasi.
GitHub
Menghubungkan repository
Lakukan satu kali untuk project baru yang dibuat dari Comote.
- 1Buat repository kosong di GitHub
Untuk menghindari konflik awal, jangan centang README atau .gitignore jika project sudah dibuat di Comote.
- 2Buka Settings di Comote
Pilih project terlebih dahulu, lalu tekan ikon roda gigi.
- 3Isi GitHub repository URL
Tempel URL repository, tekan Save remote, kemudian gunakan Push main.
- 4Pastikan VPS memiliki akses tulis
Deploy key yang ada untuk repository Comote tidak otomatis berlaku pada repository lain. Gunakan key akun GitHub untuk banyak repo, atau deploy key tersendiri per repo.
Preview & production
Lihat dulu, lalu deploy.
Preview dan production memiliki fungsi yang berbeda.
Private preview
Untuk mengecek pekerjaan
- Hanya dapat dibuka melalui Tailscale.
- Menjalankan task/session yang sedang dipilih.
- Hanya satu preview aktif pada satu waktu.
- Cocok untuk mengecek tampilan sebelum merge.
Tombol: Start preview → Open preview → Stop
Production
Untuk aplikasi yang dipakai
- Berjalan di subdomain publik
nama.apps.devop.my.id. - Mengambil canonical branch yang bersih.
- Memiliki HTTPS dan release terpisah.
- Dapat rollback ke release sebelumnya.
Tombol: Deploy production → Open production
Database cukup lewat prompt
Anda tidak perlu memasang database secara manual.
Minta Codex membuat comote.deploy.json sesuai kebutuhan. Comote sudah siap untuk SQLite, PostgreSQL, MySQL, dan Redis.
Contoh prompt
“Siapkan aplikasi ini untuk deploy di Comote. Gunakan SQLite, buat migration, persistent storage, dan health check.”Safe deploy selalu aktif. Untuk deploy langsung ke VPS mana pun, Codex akan mengecek service, port, process manager atau container, reverse proxy, folder aplikasi, disk, dan memory terlebih dahulu. App baru harus terisolasi, memiliki backup/rollback dan health check, serta tidak boleh mengganggu app atau process yang sudah ada tanpa persetujuan Anda.
Di handphone
Semua fitur penting tetap tersedia.
Gunakan menu bawah untuk berpindah antara Projects, Chat, dan Changes.
Tips nyaman dari HP
- Tambahkan Comote ke Home Screen agar terasa seperti aplikasi.
- Pilih System, Light, atau Dark dari Settings. Light memakai warna netral hangat, bukan putih terang.
- Tekan + File untuk mengirim screenshot langsung dari galeri/kamera HP sebagai referensi Codex.
- Prompt yang belum dikirim tersimpan otomatis untuk session tersebut, termasuk setelah refresh.
- Jika koneksi terputus, tunggu label Reconnecting hilang; Comote menyambung kembali secara otomatis.
- Aktifkan notifikasi Ping dari Settings agar tahu saat Codex selesai atau meminta approval.
- Review diff kecil lebih mudah daripada menunggu perubahan terlalu besar.
- Jangan menutup Tailscale bila ingin membuka Comote atau preview privat.
Contoh sehari-hari
Apa yang perlu saya tulis?
Gunakan bahasa Indonesia atau Inggris. Jelaskan hasil yang diinginkan.
“Tambahkan login email dan password. Gunakan SQLite dulu, buat test, lalu beri saya ringkasan.”
“Tombol simpan tidak bekerja di HP. Cari penyebabnya, perbaiki, lalu test pada ukuran mobile.”
“Audit security dan reliability app ini. Perbaiki temuan yang aman, jalankan test, lalu rangkum hasilnya.”
“Siapkan production config untuk Comote dengan PostgreSQL, migration, health check, dan SESSION_SECRET.”
“Baca pekerjaan terakhir di session ini dan lanjutkan bagian checkout yang belum selesai.”
“Review semua perubahan task ini, jalankan test, dan beri tahu apakah sudah aman untuk di-merge.”
Bila ada kendala
Checklist cepat
Sebagian besar masalah dapat dikenali dari pesan yang muncul di UI.
Comote tidak dapat dibuka
Pastikan aplikasi Tailscale aktif dan perangkat login ke tailnet yang sama. Comote memang tidak dapat dibuka dari internet umum.
OTP Ping belum masuk
Tunggu beberapa detik dan periksa DM dari Ping! Bot. Kode berlaku 5 menit. Tombol kirim ulang tersedia setelah 60 detik; Anda juga tetap dapat memilih Use password instead.
Import repository gagal
Periksa URL GitHub. Public repository harus dapat dibuka tanpa login. Untuk private repository, akses GitHub perlu dikonfigurasi pada VPS.
Push gagal atau meminta login
Repository tujuan belum memberikan akses tulis kepada SSH key/credential VPS, atau remote masih menggunakan metode autentikasi yang berbeda.
Preview tidak mau berjalan
Minta Codex memasang dependency dan memastikan package.json memiliki script dev atau start. Baca Preview logs untuk detail.
Project checks tidak tersedia
Comote mencari script lint, typecheck, test, build, atau check di package.json. Minta Codex menambahkan script yang sesuai untuk framework project Anda.
Project checks gagal
Buka langkah yang merah untuk melihat output. Tekan Fix with Codex agar error dikirim ke session aktif, lalu jalankan checks kembali setelah Codex selesai.
Notifikasi Ping terlalu banyak
Buka Settings → Ping notifications. Anda dapat mematikan notifikasi Codex selesai, approval, checks gagal, atau hasil deploy secara terpisah.
Deploy production gagal
Pastikan canonical branch bersih, dependency memiliki package-lock.json, required secret sudah disimpan, dan health check aplikasi berhasil.
Ada conflict saat Merge
Jangan memaksa merge. Kembali ke session task dan minta: “Selesaikan conflict dengan main, jalankan test, lalu commit hasilnya.”
Indikator masih menampilkan Context —
Ini normal untuk session lama yang belum memiliki data usage tersimpan. Kirim satu pesan dan tunggu Codex menyelesaikan jawabannya; persentase akan muncul setelah event token usage diterima.
Kapan memakai Compact dan kapan fresh session?
Gunakan Compact bila masih mengerjakan topik yang sama. Gunakan Continue in fresh session bila percakapan sudah sangat panjang, indikator merah, atau Anda mulai fase kerja baru tetapi ingin mempertahankan branch dan semua file.
Tidak sengaja membuat session baru
Buka session tersebut, tekan •••, lalu pilih Delete permanently. Untuk session yang mungkin masih diperlukan, pilih Archive session agar dapat dipulihkan kemudian.
Siap mulai?
Buka Comote dan katakan apa yang ingin Anda buat.
Mulai dari perubahan kecil, review hasilnya, lalu gunakan workflow commit → merge → push → deploy.