Alat Baris Perintah LabelGrid (CLI)

Q: Apakah LabelGrid punya alat baris perintah?

Ya. LabelGrid menerbitkan alat baris perintah resmi sebagai paket npm @labelgrid/cli. Pasang dengan npm install -g @labelgrid/cli dan perintah labelgrid akan tersedia di terminal Anda. Alat ini memerlukan Node.js 20 atau yang lebih baru. CLI adalah lapisan tipis di atas API publik LabelGrid, jadi ia bekerja dengan katalog, file, analitik, dan tindakan distribusi yang sama seperti yang ditawarkan API.

Q: Apa saja yang bisa saya lakukan dengan CLI LabelGrid?

Anda bisa masuk dan mengelola token; mencari, melihat, membuat, memperbarui, dan menghapus label, artis, penulis, penerbit, rilis, dan track; mengunggah audio, artwork, lirik, dan motion artwork; memvalidasi rilis, mengirimnya untuk distribusi, dan menariknya kembali; menarik laporan, transaksi, royalti, dan analitik streaming; melihat masalah tinjauan dan laporan kualitas; mengelola webhook; serta mengelola pengaktifan Beatport. Setiap perintah dijalankan lewat API publik LabelGrid, jadi apa pun yang ditolak API akan ditolak CLI dengan cara yang sama.

Q: Bagaimana cara mengautentikasi CLI?

CLI memakai token API LabelGrid. Token dicari di tiga tempat secara berurutan: variabel lingkungan LABELGRID_API_TOKEN, lalu kredensial yang Anda simpan dengan labelgrid auth login (tersimpan di Keychain macOS, atau di file dengan izin terbatas di bawah ~/.config/labelgrid pada sistem lain), lalu flag --token. Sebaiknya pakai labelgrid auth login, yang meminta token dengan input tersembunyi, sehingga token tidak pernah masuk ke riwayat shell atau daftar proses Anda. CLI tidak pernah mencetak nilai token.

Q: Apa bedanya CLI dengan server MCP?

Keduanya adalah alat resmi LabelGrid yang dibangun di atas API publik yang sama. CLI ditujukan untuk terminal dan skrip Anda: Anda mengetik perintah atau menjalankannya dalam otomatisasi. Server MCP ditujukan untuk asisten AI seperti Claude dan Cursor, yang memanggil API untuk Anda lewat bahasa sehari-hari. Pakai yang paling cocok dengan alur kerja Anda, atau keduanya.

Diperbarui Juli 2026.

LabelGrid menerbitkan alat baris perintah resmi agar Anda bisa mengelola akun langsung dari terminal atau dari sebuah skrip. Alat ini adalah paket npm @labelgrid/cli, dan memasangnya akan menambahkan perintah labelgrid ke komputer Anda.

CLI adalah lapisan tipis di atas API publik LabelGrid: validasi yang sama dan izin yang sama. Setiap perintah dipetakan ke satu panggilan API, jadi apa pun yang ditolak API akan ditolak CLI dengan cara yang persis sama, dan tidak ada perintah CLI yang bisa melakukan sesuatu di luar izin token Anda. CLI mencakup kelompok perintah yang tercantum di bawah, bukan setiap endpoint yang diterbitkan API; untuk sudut API yang belum punya perintah padanannya, panggil endpoint-nya secara langsung. Jika Anda lebih suka bekerja dengan bahasa sehari-hari lewat asisten AI, LabelGrid juga menerbitkan server MCP yang dibangun di atas API yang sama.

Apa saja yang bisa Anda lakukan

Perintah disusun dalam beberapa kelompok. Dari terminal Anda bisa:

auth — masuk, keluar, memeriksa sedang masuk sebagai siapa, dan mencabut token
catalog — mencari, melihat, membuat, memperbarui, dan menghapus label, artis, penulis, penerbit, rilis, dan track
release — memvalidasi rilis, mengirimnya untuk distribusi, menariknya kembali, mengonfirmasi tinjauan, serta mengelola landing page dan tautan pendeknya
upload — menambahkan audio, artwork, lirik, dan motion artwork (tiap jenis hanya menerima ekstensi file yang diizinkan untuknya)
download, asset, license — mengambil file dan mengelola lisensi
statement, transactions, royalties, analytics — menarik laporan, transaksi, rincian royalti, dan analitik streaming
review — melihat masalah tinjauan, membaca laporan kualitas, dan menambahkan catatan
webhook — mendaftarkan dan mengelola webhook untuk notifikasi asinkron
beatport — mengelola pengaktifan Beatport

Yang Anda butuhkan

Akun LabelGrid dengan akses API. Akses API adalah bagian dari paket API LabelGrid; lihat Ikhtisar API untuk cara mendapatkannya.
Token API. Buat satu di dashboard LabelGrid Anda di bawah Profile → API Tokens.
Node.js 20 atau yang lebih baru di komputer tempat Anda menjalankan CLI.

Pemasangan

Pasang CLI secara global dengan npm:

npm install -g @labelgrid/cli

Ini menambahkan perintah labelgrid. Pastikan pemasangannya berhasil dengan:

labelgrid --version

Autentikasi

CLI membutuhkan token API Anda. Token dicari di tiga tempat, dengan urutan berikut:

Variabel lingkungan LABELGRID_API_TOKEN — paling cocok untuk skrip dan CI, dengan nilai yang berasal dari penyimpanan rahasia penyedia CI Anda.
Kredensial tersimpan yang Anda simpan sekali dengan labelgrid auth login. Di macOS kredensial ini disimpan di Keychain; di sistem lain disimpan ke file dengan izin terbatas di bawah ~/.config/labelgrid/.
Flag --token pada satu perintah tertentu — pilihan terakhir.

Di komputer Anda sendiri, cara paling aman adalah menyimpan token sekali saja. Jalankan labelgrid auth login tanpa argumen, dan CLI akan meminta Anda menempelkan token dengan input tersembunyi, sehingga nilainya tidak pernah muncul di layar atau di riwayat shell Anda:

labelgrid auth login

Setiap perintah berikutnya memakai kembali kredensial tersimpan itu, jadi Anda tidak perlu mengetik tokennya lagi:

labelgrid auth whoami

Untuk penyiapan tanpa pengawasan yang tidak memungkinkan adanya prompt, salurkan token ke labelgrid auth login dari sebuah pengelola rahasia alih-alih meneruskannya sebagai argumen:

my-secret-manager read labelgrid-token | labelgrid auth login

CLI tidak pernah mencetak nilai token. Untuk menghentikan akses, keluar dengan labelgrid auth logout — yang menghapus kredensial tersimpan dari mesin tersebut — atau cabut tokennya dari dashboard Anda, yang seketika menghentikan token itu bekerja di mana pun. Token lain di akun Anda tetap berfungsi; cabut satu per satu token yang ingin Anda hentikan penggunaannya.

Keluaran dan kode keluar

Secara default CLI mencetak keluaran yang rapi dan mudah dibaca manusia. Untuk keperluan skrip, tambahkan --json pada perintah apa pun dan CLI akan mencetak respons API mentah sehingga Anda bisa menyalurkannya ke alat lain:

labelgrid catalog search releases --query "summer" --json

Perintah menetapkan kode keluar standar agar skrip Anda bisa menanggapi hasilnya:

Kode keluar	Arti
`0`	Berhasil
`1`	Kesalahan API (permintaan sampai ke LabelGrid dan ditolak)
`2`	Kesalahan penggunaan (ada kekeliruan pada perintahnya sendiri)

Keamanan

Perintah yang bersifat final dan destruktif meminta konfirmasi Anda sebelum apa pun dikirim. Mengirim rilis untuk distribusi, menarik kembali sebuah rilis, mengonfirmasi tinjauan, menghapus item katalog, dan mengaktifkan Beatport semuanya meminta Anda mengetik y untuk mengonfirmasi sebelum CLI melakukan panggilan API apa pun.

Untuk otomatisasi tanpa ada orang yang mengawasi, tambahkan --yes untuk melewati permintaan konfirmasi:

labelgrid release distribute REL123 --yes

Setiap perlindungan akun, mulai dari validasi, batas paket, sampai batas laju permintaan, diberlakukan oleh server LabelGrid, jadi CLI tidak bisa menghindarinya dengan cara apa pun Anda menjalankannya.

Pemecahan masalah

command not found: labelgrid — pemasangan global belum selesai atau tidak ada di PATH Anda. Jalankan ulang npm install -g @labelgrid/cli dan pastikan Node.js 20 atau yang lebih baru dengan node --version.
Token tidak valid atau ditolak — buat ulang tokennya di dashboard Anda di bawah Profile → API Tokens, lalu simpan lagi dengan labelgrid auth login.
Anda tidak melihat halaman “API Tokens” — akun Anda belum memiliki akses API. Lihat Ikhtisar API untuk cara mengaktifkannya.
Sebuah perintah gagal di dalam skrip — periksa kode keluarnya (1 berarti kesalahan API, 2 berarti kesalahan penggunaan) lalu jalankan ulang perintah yang sama dengan --json untuk membaca respons lengkapnya.

FAQ

”Apakah LabelGrid punya alat baris perintah?”

Ya. LabelGrid menerbitkan CLI resmi sebagai paket npm @labelgrid/cli. Pasang dengan npm install -g @labelgrid/cli dan perintah labelgrid akan tersedia di terminal Anda. Alat ini memerlukan Node.js 20 atau yang lebih baru dan merupakan lapisan tipis di atas API publik LabelGrid.

”Apa saja yang bisa saya lakukan dengannya?”

Masuk dan mengelola token; mencari, melihat, membuat, memperbarui, dan menghapus label, artis, penulis, penerbit, rilis, dan track; mengunggah audio, artwork, lirik, dan motion artwork; memvalidasi rilis, mengirimnya untuk distribusi, dan menariknya kembali; menarik laporan, transaksi, royalti, dan analitik streaming; melihat masalah tinjauan dan laporan kualitas; mengelola webhook; serta mengelola pengaktifan Beatport.

”Bagaimana cara mengautentikasi CLI?”

Dengan token API LabelGrid. CLI mencarinya di tiga tempat secara berurutan: variabel lingkungan LABELGRID_API_TOKEN, lalu kredensial yang tersimpan lewat labelgrid auth login, lalu flag --token. Sebaiknya pakai labelgrid auth login — perintah ini meminta token dengan input tersembunyi, sehingga nilainya tidak pernah sampai ke riwayat shell atau daftar proses Anda. CLI tidak pernah mencetak nilai token.

”Apakah saya perlu paket API?”

Ya. CLI terhubung melalui API publik LabelGrid, jadi akun Anda memerlukan akses API, yang merupakan bagian dari paket API LabelGrid. Lihat Ikhtisar API untuk cara mendapatkan aksesnya.

”Apa bedanya CLI dengan server MCP?”

Keduanya adalah alat resmi LabelGrid di atas API publik yang sama. CLI ditujukan untuk terminal dan skrip Anda; server MCP ditujukan untuk asisten AI seperti Claude dan Cursor yang memanggil API untuk Anda lewat bahasa sehari-hari. Pakai yang paling cocok dengan alur kerja Anda, atau keduanya.

Terkait

Ikhtisar API dan Panduan Cepat — cara mendapatkan akses API dan mengautentikasi
Hubungkan Asisten AI Anda ke LabelGrid (MCP) — tindakan yang sama, lewat bahasa sehari-hari
Webhooks — notifikasi peristiwa asinkron
@labelgrid/cli di npm
Dokumentasi di GitHub — referensi CLI ada di bawah packages/cli

Butuh bantuan?

Jika Anda punya pertanyaan tentang CLI, hubungi tim dukungan kami.

Belum menggunakan LabelGrid?

Semua yang baru saja Anda baca tersedia di platform kami.

Lihat kemampuan LabelGrid →