Studio CLI

Teks ini diterjemahkan menggunakan AI. Jika Anda ingin melihat teks asli dalam bahasa Inggris, klik di sini.

Studio CLI adalah utilitas baris perintah yang tersedia secara global dan memungkinkan Anda berinteraksi dengan fitur WordPress Studio dari terminal, baik Studio sedang terbuka maupun tidak.

Ini sangat berguna untuk:

• Mengelola situs Studio lokal.
• Membuat dan memperbarui situs pratinjau di WordPress.com.
• Menjalankan perintah WP-CLI.
• Berintegrasi dengan agen coding AI. Setiap situs dilengkapi dengan file AGENTS.md.
• Mengintegrasikan Studio ke dalam skrip dan langkah build.

Instalasi

1. Buka aplikasi “WordPress Studio”.
2. Dari menu utama, buka modal Pengaturan. Anda juga dapat mengeklik ikon roda gigi di sudut kanan atas aplikasi.
3. Aktifkan opsi “Studio CLI” dan klik Simpan.
4. Di macOS, Anda akan diminta memasukkan kata sandi akun untuk mengizinkan instalasi.

Penggunaan

Studio CLI dijalankan dengan perintah studio. Semua perintah mengikuti pola:

studio <area> <command> [options]

Anda dapat melihat ikhtisar tingkat tinggi kapan saja dengan:

studio --help

Sebagian besar perintah dirancang untuk dijalankan dari direktori root situs yang dikelola Studio. Untuk menargetkan direktori situs yang berbeda dari direktori kerja Anda saat ini, gunakan opsi --path:

studio <area> <command> --path /path/to/site

Perintah autentikasi

Gunakan perintah auth untuk mengelola autentikasi WordPress.com Anda untuk fitur Studio yang memerlukan pengguna yang sudah login (misalnya, situs pratinjau).

studio auth login      # Log in to WordPress.com
studio auth logout     # Log out and clear WordPress.com authentication
studio auth status     # Check authentication status

• studio auth login membuka alur berbasis browser untuk menghubungkan CLI ke akun WordPress.com Anda. Anda akan menerima token autentikasi untuk ditempelkan ke terminal guna menyelesaikan proses login.
• studio auth status melaporkan apakah Anda saat ini sudah diautentikasi dan menampilkan akun mana yang sedang digunakan.
• studio auth logout memutuskan koneksi CLI dari akun WordPress.com Anda dan menghapus kredensial yang tersimpan.

Jika Anda menjalankan perintah yang memerlukan autentikasi (seperti studio preview create) saat sudah logout, CLI akan menampilkan error dan mengarahkan Anda untuk login.

Gunakan flag --help untuk opsi terperinci pada perintah auth apa pun:

studio auth --help
studio auth login --help

Perintah situs pratinjau

Situs pratinjau adalah lingkungan sementara yang dapat dibagikan dan dihosting di WordPress.com, yang mencerminkan situs Studio lokal Anda. Gunakan situs ini untuk membagikan pekerjaan kepada rekan satu tim atau pemangku kepentingan tanpa memerlukan lingkungan lokal.

studio preview create          # Create a preview site
studio preview list            # List preview sites
studio preview update <host>   # Update an existing preview site
studio preview delete <host>   # Delete a preview site

Membuat situs pratinjau

Dari root situs Studio lokal Anda:

cd /path/to/your/studio-site
studio preview create

Ini akan:

• Buat dan unggah situs lokal Anda ke lingkungan pratinjau.
• Kembalikan URL pratinjau yang dapat Anda bagikan kepada orang lain.
• Mengharuskan Anda sudah login dengan studio auth login.

Anda juga dapat menentukan direktori situs secara eksplisit:

studio preview create --path /path/to/your/studio-site

Mencantumkan situs pratinjau

Untuk melihat semua situs pratinjau yang terkait dengan akun Anda:

studio preview list

Ini menampilkan host setiap pratinjau (misalnya, example-preview.wpcomstaging.com), yang akan Anda gunakan dengan perintah update dan delete.

Memperbarui dan menghapus situs pratinjau

Setiap situs pratinjau diidentifikasi berdasarkan nama host-nya:

# Rebuild and redeploy changes from your local site to the preview site:
studio preview update <host>

# Permanently remove a preview site:
studio preview delete <host>

Gunakan studio preview list untuk menemukan nilai <host> yang sesuai jika Anda tidak memilikinya.

Untuk kumpulan opsi lengkap:

studio preview --help
studio preview create --help
studio preview update --help
studio preview delete --help

Perintah pengelolaan situs lokal

Gunakan perintah site untuk mengelola situs Studio lokal di mesin Anda: membuat, memulai, menghentikan, mencantumkan, dan mengonfigurasinya.

studio site status    # Get status of local site
studio site create    # Create a new local site
studio site list      # List local sites
studio site start     # Start local site
studio site stop      # Stop local site(s)
studio site delete    # Delete local site
studio site set       # Configure site settings

Membuat situs lokal

Anda dapat menjalankan perintah create dari direktori kosong, atau direktori yang sudah berisi berkas-berkas situs WordPress, tetapi belum tercantum di Studio.

Untuk membuat situs lokal baru yang dikelola oleh Studio:

# Create a new site in the current working directory, using all the default options
studio site create

# Create a new site with a custom domain and HTTPS
studio site create --https --domain hello.wp.local

# Create a new site in a different directory
studio site create --path /path/to/site

Ini akan membuat situs baru di direktori kerja Anda saat ini, memulai server WordPress, dan membuka wp-admin di browser Anda secara otomatis setelah selesai.

Ada beberapa flag yang didukung dan dapat Anda gunakan saat membuat situs baru. Untuk melihat rangkaian opsi lengkap:

studio site create --help

Membuat situs lokal menggunakan Galeri Blueprints

Studio menyediakan akses ke Galeri Blueprints, tempat Anda dapat memilih dan mengaktifkan blueprint untuk membuat situs. Galeri Blueprints juga tersedia melalui CLI. Perintah untuk bekerja dengan blueprint adalah:

# Show all available blueprints for creating a local Studio site
studio blueprint list

# Create a local site with selected blueprint
studio blueprint use <blueprint-slug> --name "<site-name>"

Mencantumkan dan memeriksa situs

# Show all local sites known to Studio:
studio site list

# Show details and current status for the site in the current directory:
studio site status

# Or explicitly for a given path:
studio site status --path /path/to/site

Output status mencakup informasi seperti:

• Apakah situs sedang berjalan.
• URL lokal (misalnya, http://localhost:PORT).
• Detail konfigurasi utama (versi PHP, status database, dll.).

Memulai dan menghentikan situs

# From inside a site directory:
studio site start
studio site stop

# Or by path:
studio site start --path /path/to/site
studio site stop --path /path/to/site

Memulai situs akan menjalankan layanan lokal yang diperlukan untuk mengaksesnya di browser, sedangkan menghentikannya akan mematikan layanan tersebut.

Menghapus situs lokal

# Delete a site from Studio
studio site delete

# Delete the site and move the site directory to the system trash
studio site delete --files

Tindakan ini menghapus situs dari Studio dan, secara opsional, file situs dari disk.

Mengonfigurasi pengaturan situs

Gunakan studio site set untuk menyesuaikan pengaturan situs lokal tertentu.

studio site set [options]

Contoh penggunaan perintah ini meliputi:

• Mengubah versi PHP atau versi WordPress.
• Menyesuaikan domain atau port lokal.
• Mengaktifkan/menonaktifkan fitur yang memengaruhi cara lingkungan lokal berjalan.

Untuk melihat daftar lengkap opsi yang dapat dikonfigurasi, jalankan:

studio site set --help

Menggunakan WP-CLI melalui Studio

Perintah studio wp memberi Anda akses ke WP-CLI dalam konteks situs yang dikelola Studio, tanpa mengharuskan Anda menginstal atau mengonfigurasi WP-CLI secara terpisah.

studio wp [<wp-cli-command>] [<wp-cli-arguments>...]

Contoh (jalankan dari direktori root situs Anda):

# Check WordPress version:
studio wp core version

# List installed plugins:
studio wp plugin list

# Run database upgrades:
studio wp core update-db

Poin utama:

• Anda tidak memerlukan instalasi WP-CLI terpisah; Studio menyediakan dan mengonfigurasinya untuk Anda.
• Variabel lingkungan, path, dan kredensial otomatis ditetapkan berdasarkan situs yang dipilih, sehingga perintah dijalankan pada database dan file yang benar.
• Anda dapat menggunakan --path jika Anda tidak berada di direktori situs:

  studio wp plugin list --path /path/to/site

Untuk daftar lengkap subcommand dan argumen WP-CLI yang didukung, lihat dokumentasi WP-CLI atau jalankan:

studio wp help
studio wp help <command>

Menggunakan Studio CLI dengan agen coding AI

Studio CLI bekerja dengan baik bersama alat dan agen pengembangan berbantuan AI seperti Claude Code, Cursor, dan ekstensi IDE lainnya yang dapat menjalankan perintah shell untuk Anda.

Karena alat-alat ini dapat melihat file proyek Anda dan menjalankan perintah terminal, alat-alat tersebut dapat:

• Mendeteksi bahwa Anda sedang bekerja di proyek WordPress yang dikelola Studio.
• Memanggil perintah studio secara otomatis untuk mengelola situs lokal, pratinjau, dan tugas WP-CLI.
• Menggunakan output perintah untuk memandu perubahan kode atau langkah debugging berikutnya.

Alur kerja umum dengan agen AI

Berikut beberapa cara konkret untuk menggabungkan Studio CLI dengan agen coding AI.

1. Menjalankan dan mengelola situs lokal

Anda dapat menginstruksikan agen AI untuk membuat dan menjalankan situs WordPress lokal melalui Studio. Misalnya, di editor Anda:

“Siapkan situs WordPress lokal baru menggunakan PHP versi 8.2 dengan Studio di folder ini, jalankan, dan beri tahu saya URL lokalnya.”

Di balik layar, agen mungkin menjalankan:

studio site create --php 8.2
studio site start
studio site status

Ini berguna saat:

• Membuat prototipe plugin atau tema baru dengan cepat.
• Mulai mengerjakan proyek yang sudah ada dan Anda ingin agen menyiapkan lingkungannya untuk Anda.

2. Debugging otomatis dan operasi WP-CLI

Saat agen menyarankan perbaikan atau perubahan, agen juga dapat menjalankan pemeriksaan menggunakan studio wp:

# Run database upgrades:
studio wp core update-db

# Check for current plugins:
studio wp plugin list

Anda mungkin bertanya:

“Jalankan pemeriksaan WP-CLI apa pun yang diperlukan melalui Studio untuk mendiagnosis mengapa situs menampilkan error 500, lalu usulkan perbaikannya.”

Agen dapat melakukan proses secara iteratif:

1. Menjalankan perintah studio wp untuk mengumpulkan diagnostik.
2. Memperbarui kode atau konfigurasi.
3. Menjalankan ulang perintah untuk memverifikasi perbaikan.

3. Membuat dan memperbarui situs pratinjau untuk peninjauan

Agen dapat membantu Anda menyiapkan dan memelihara lingkungan pratinjau yang terkait dengan branch atau fitur Anda:

“Buat situs pratinjau untuk proyek ini dan berikan URL yang dapat dibagikan. Lalu, setelah setiap perubahan kode, perbarui pratinjau yang sama.”

Yang berarti:

studio auth login              # if needed
studio preview create          # initial deployment
studio preview update <host>   # after subsequent changes

Ini sangat berguna ketika:

• Membagikan progres kepada pemangku kepentingan non-teknis.
• Berkolaborasi dengan rekan tim yang perlu melihat perilaku live tanpa menyiapkan lingkungan lokal.

Praktik terbaik saat menggunakan agen AI dengan Studio CLI

• Tetap berada di root situs Studio: Banyak perintah mengasumsikan direktori saat ini adalah situs yang dikelola Studio. Ingatkan agen Anda untuk menjalankan cd ke folder yang benar atau menggunakan --path.
• Berikan instruksi secara jelas: Saat memberi prompt kepada agen, sebutkan “gunakan CLI studio” dan batasan apa pun, misalnya:
  • “Jangan hapus situs yang sudah ada.”
  • “Minta konfirmasi sebelum menjalankan migrasi database.”
  • “Hanya jalankan perintah studio wp yang bersifat baca-saja.”
• Tinjau operasi yang merusak: Perintah seperti studio site delete dan studio preview delete dapat menghapus lingkungan. Minta agen menampilkan perintah yang rencananya akan dijalankan sebelum mengeksekusinya.
• Gunakan autentikasi dengan sengaja: Untuk perintah yang memerlukan akses WordPress.com (studio auth login, studio preview ...), pastikan Anda nyaman dengan agen yang memulai alur login, dan konfirmasi akun mana yang digunakan.

Dengan menggabungkan Studio CLI dengan agen coding AI, Anda dapat mengalihkan banyak tugas berulang seperti penyiapan lingkungan, pengujian, dan orkestrasi deployment, sehingga dapat lebih fokus menulis dan meninjau kode WordPress Anda.

Mendapatkan bantuan

Setiap perintah dan subperintah mendukung --help untuk dokumentasi inline, penggunaan, dan opsi yang tersedia. Misalnya:

studio --help
studio auth --help
studio preview create --help
studio site start --help
studio site set --help
studio wp help

Ini adalah cara terbaik untuk menjelajahi kemampuan versi Studio CLI tertentu yang telah Anda instal.