Walse

Posted on Mar 17 • Originally published at apidog.com

Cara Menggunakan CLI-Anything: Jadikan Software Apapun Agent-Native

#agents #ai #cli #tutorial

CLI-Anything

CLI-Anything adalah plugin open-source untuk agen coding AI (khususnya Claude Code) yang dapat menghasilkan antarmuka baris perintah (CLI) lengkap untuk perangkat lunak apa saja yang memiliki basis kode. Arahkan ke GIMP, Blender, LibreOffice, atau aplikasi lain, lalu plugin ini akan menganalisis kode sumber dan menghasilkan CLI terstruktur sehingga agen AI Anda bisa mengontrol perangkat lunak tersebut secara terprogram.

Coba Apidog hari ini

Masalah: Agen AI Tidak Bisa Menggunakan Perangkat Lunak GUI

Tumpukan perangkat lunak modern terbagi dua: layanan API-first (cloud storage, payment, email, analytics) bisa dipanggil AI langsung via HTTP, sedangkan perangkat lunak desktop seperti GIMP, Blender, LibreOffice, dan Audacity hanya menyediakan GUI untuk manusia.

Jika Anda ingin menghubungkan agen AI ke perangkat lunak desktop, ada dua pilihan lama: menulis wrapper custom (lama dan rawan rusak saat software update), atau menggunakan RPA (otomatisasi klik GUI, tapi rapuh dan mudah rusak saat UI berubah).

CLI-Anything mengambil pendekatan berbeda: menganalisis kode sumber aplikasi, menemukan API internal yang dipanggil GUI, lalu membangun CLI yang memanggil API tersebut secara langsung. Agen AI cukup mengeksekusi perintah terstruktur—tanpa perlu “melihat” layar.

💡 Jika alur kerja Anda juga perlu memanggil REST API eksternal selain software lokal, Apidog bisa membantu testing API. Apidog adalah alat gratis untuk mengirim, memeriksa, dan mengatur permintaan API, sehingga Anda bisa memverifikasi integrasi API sebelum membangun ke workflow agen Anda.

Apa yang Dilakukan CLI-Anything

CLI-Anything adalah plugin open-source dari HKUDS (Hong Kong University Data Science Lab). Chao Huang, penciptanya, menyebut:

"Perangkat lunak hari ini melayani manusia. Pengguna besok akan menjadi agen. CLI-Anything: menjembatani kesenjangan antara agen AI dan perangkat lunak dunia. Satu baris perintah untuk membuat perangkat lunak apa pun siap untuk agen."

Plugin ini bekerja di Claude Code (utama) dan secara eksperimental di Codex dan OpenCode. Proses otomatisnya terdiri dari 7 fase:

Analisis: Pindai kode sumber, mapping aksi GUI ke API internal, buat dokumentasi SOP khusus.
Desain: Atur grup perintah, model status, format output.
Implementasi: Bangun CLI Python (framework Click) dengan REPL, output --json, undo/redo.
Rencana Pengujian: Buat file TEST.md untuk rencana pengujian unit dan end-to-end.
Tulis Pengujian: Buat test_core.py (unit test) dan test_full_e2e.py (end-to-end).
Dokumentasi: Jalankan pytest, hasilnya ditulis ke TEST.md.
Publikasi: Buat setup.py, konfigurasi entry point, install ke PATH.

Setelah 7 fase, Anda mendapatkan CLI siap pakai. Agen AI bisa mendeteksi (which cli-anything-gimp), cek help (cli-anything-gimp --help), dan langsung eksekusi perintah.

Desain CLI konsisten: output tabel (default), output JSON (--json), status persisten, undo/redo, dan REPL interaktif. Semua CLI hasil generasi mengikuti standar ini.

Menginstal CLI-Anything

CLI-Anything berbasis Python, bukan npm. Anda install ke lingkungan agen AI, dan CLI hasil generate bisa diinstall via pip install -e ..

Persyaratan:

Python 3.10+
Perangkat lunak target sudah terinstal
Agen AI coding yang didukung (Claude Code utama, Codex/OpenCode eksperimental)

Claude Code (Utama)

/plugin marketplace add HKUDS/CLI-Anything
/plugin install cli-anything

Ini menambahkan perintah /cli-anything di Claude Code.

OpenCode

Clone repo, lalu salin file command dan HARNESS.md ke ~/.config/opencode/commands/. Anda dapatkan lima perintah: /cli-anything, /cli-anything-refine, /cli-anything-test, /cli-anything-validate, /cli-anything-list.

Codex

bash CLI-Anything/codex-skill/scripts/install.sh

Qodercli

bash CLI-Anything/qoder-plugin/setup-qodercli.sh

Catatan Windows

Butuh Git for Windows (bash & cygpath) atau WSL. Shell Windows asli tidak didukung. Jika muncul error cygpath: command not found, install Git for Windows dan ulangi.

Menginstal CLI yang Dihasilkan

Setelah plugin menghasilkan CLI, install ke PATH:

cd <software>/agent-harness
pip install -e .

Mode editable (-e) memungkinkan Anda mengedit sumber tanpa reinstall.

Menghasilkan CLI Pertama Anda

Setelah plugin terinstal, generate CLI hanya dengan satu perintah. Contoh untuk GIMP:

Di Claude Code:

/cli-anything ./gimp

Dari repo GitHub:

/cli-anything https://github.com/blender/blender

Pipeline 7 fase akan berjalan. Proses bisa memakan waktu beberapa menit sesuai ukuran kode.

Fase 1 (Analisis): Plugin membaca kode sumber, mapping aksi GUI ke API internal, menghasilkan dokumen SOP (GIMP.md).
Fase 3 (Implementasi): Membangun CLI dengan Python Click; semua perintah support --json, status project dalam file JSON, REPL dengan prompt warna dan riwayat.

Struktur direktori:

gimp/
  agent-harness/
    GIMP.md           # SOP software
    setup.py
    cli_anything/
      gimp/
        README.md
        gimp_cli.py   # Entry CLI utama
        core/
        utils/
        tests/
          test_core.py
          test_full_e2e.py
          TEST.md

Semua CLI ada dalam namespace cli_anything.* (misal, cli_anything.gimp).

Menggunakan CLI yang Dihasilkan

Setelah pip install -e ., Anda punya CLI baru:

cli-anything-gimp --help

Daftar semua grup perintah dan sub-perintah tersedia. Nama konsisten: cli-anything-<software>.

Output Human-Readable (Default)

# Buat proyek baru
cli-anything-gimp project new --width 1920 --height 1080

# Daftar layer
cli-anything-gimp layer list

# Tambah layer
cli-anything-gimp layer add --name "Background" --type solid --color "#ffffff"

# Terapkan filter
cli-anything-gimp filter apply --name "gaussian-blur" --radius 3

# Ekspor
cli-anything-gimp export save --format png --output ./output.png

Output JSON untuk Agen AI

cli-anything-gimp --json project new --width 1920 --height 1080
# {"status": "ok", "project_id": "proj_abc123", "width": 1920, "height": 1080}

cli-anything-gimp --json layer add -n "Background"
# {"status": "ok", "layer_id": "layer_001", "name": "Background"}

Output JSON konsisten di semua perintah: status, field khusus operasi, serta error jika ada.

Mode REPL Interaktif

cli-anything-gimp

Masuk shell interaktif dengan prompt warna, tab-completion, dan riwayat.

Undo/Redo

cli-anything-gimp undo
cli-anything-gimp redo

Undo stack hingga 50 langkah.

Memperbaiki dan Menguji CLI Anda

CLI hasil generate kadang belum lengkap. Gunakan /cli-anything:refine untuk analisis celah dan penambahan perintah yang hilang.

Perbaikan Umum

/cli-anything:refine /home/user/gimp

Mencari gap antara CLI dan permukaan API software, lalu menambah perintah baru.

Perbaikan Terfokus

/cli-anything:refine /home/user/blender "particle systems and physics simulation"

Fokus di area tertentu sesuai kebutuhan.

Menjalankan Pengujian

/cli-anything:test /home/user/gimp

Jalankan suite testing, hasilnya diupdate ke TEST.md.

Validasi

/cli-anything:validate /home/user/gimp

Validasi CLI sesuai spesifikasi HARNESS.md.

Mencantumkan CLI yang Tersedia

/cli-anything:list
/cli-anything:list --json
/cli-anything:list --path /home

Kasus Penggunaan Dunia Nyata

CLI-Anything sudah diuji pada 11 aplikasi. Berikut contoh alur kerja nyata:

Pipeline Pemrosesan Gambar dengan GIMP

Agen AI bisa otomatis resize gambar produk, watermark, dan ekspor massal:

cli-anything-gimp project open --file product.jpg
cli-anything-gimp layer add --name "Watermark" --type image --source watermark.png
cli-anything-gimp layer position --name "Watermark" --x 10 --y 10
cli-anything-gimp export save --format webp --output product-final.webp

Generasi Dokumen dengan LibreOffice

Generate invoice PDF otomatis:

cli-anything-libreoffice document open --template invoice-template.ods
cli-anything-libreoffice cell set --address "B5" --value "Acme Corp"
cli-anything-libreoffice cell set --address "C10" --value "1500.00"
cli-anything-libreoffice export pdf --output invoice-2026-001.pdf

Rendering 3D dengan Blender

Render otomatis tanpa GUI:

cli-anything-blender scene open --file product-scene.blend
cli-anything-blender render set --samples 256 --output /renders/product
cli-anything-blender render start --format png

Otomatisasi Streaming dengan OBS Studio

Skrip transisi dan rekaman OBS:

cli-anything-obs scene set --name "Main Camera"
cli-anything-obs recording start
cli-anything-obs scene set --name "Screen Share"
cli-anything-obs recording stop --output session.mp4

Integrasi CI/CD

Semua CLI bisa diintegrasikan ke pipeline, misal rendering Blender di GitHub Actions atau generate PDF otomatis.

Membangun Alur Kerja Agen dengan Apidog

CLI-Anything menangani software lokal, tapi workflow umumnya juga butuh integrasi API eksternal—misal upload hasil GIMP ke CDN, push PDF dari LibreOffice ke document management, atau kirim video Blender ke platform review.

Apidog adalah klien API gratis untuk menguji, dokumentasi, dan mengotomatiskan call REST API.

Contoh workflow:

Proses gambar di GIMP via CLI-Anything, upload ke API cloud storage.
Apidog dipakai untuk:
1. Setup environment & variable API key
2. Uji endpoint upload dengan file sample
3. Verifikasi response & URL hasil
4. Export request jadi curl/code snippet untuk skrip agen

Dengan Apidog, Anda bisa pastikan API sudah benar sebelum integrasi ke workflow. Setelah workflow stabil, tambahkan automated test suite di Apidog agar regression test jalan tiap eksekusi.

Batasan yang Perlu Diketahui

Dukungan Windows Butuh Git Bash/WSL

CLI hasil generate Python-based, mengandalkan path bash. Di Windows, gunakan Git for Windows atau WSL. PowerShell tidak didukung.

Software Target Harus Terinstal

CLI-Anything tidak membundel software target. GIMP, Blender, LibreOffice, dsb harus sudah ada di mesin yang sama.

Output Hanya Python

Semua CLI yang dihasilkan berbasis Python Click. Jika butuh CLI Node.js atau Go, Anda harus membangunnya sendiri.

Claude Code Platform Utama

Claude Code paling stabil. Codex/OpenCode masih eksperimental.

Kualitas Tergantung Basis Kode

Plugin menganalisis source code. Jika kode acak-acakan atau terlalu terikat GUI, bisa saja analisisnya tidak lengkap. Langkah refine membantu, tapi software proprietary yang kompleks lebih sulit dibungkus.

FAQ

Apakah CLI-Anything bekerja untuk software apa saja?

Prinsipnya ya, selama ada akses ke source code. Paling cocok untuk software open-source yang mapping GUI ke API-nya jelas. Sudah diuji di GIMP, Blender, Inkscape, Audacity, Kdenlive, Shotcut, OBS Studio, Draw.io, LibreOffice, AnyGen, dan Zoom.

Apakah gratis?

Ya, lisensi MIT, open-source di github.com/HKUDS/CLI-Anything.

Perlu bisa Python?

Tidak, Anda tidak perlu menulis Python. Tapi, butuh Python 3.10+ untuk menjalankan CLI.

Bisa dipanggil dari kode sendiri?

Bisa, CLI hasil generate adalah executable biasa, bisa dipanggil shell, Makefile, Python subprocess, dll.

Apa itu HARNESS.md?

HARNESS.md adalah spesifikasi harness CLI: struktur perintah, format output, requirement testing & packaging. Langkah validasi akan cek terhadap file ini.

Bisa untuk software internal?

Bisa, arahkan plugin ke source code apapun di sistem Anda. Semua proses berjalan lokal.

Perbandingan dengan Model Context Protocol (MCP)?

MCP menghubungkan agen AI ke layanan cloud via protokol standar. CLI-Anything membungkus aplikasi GUI lokal ke CLI. Bisa dipakai bersamaan: MCP untuk cloud, CLI-Anything untuk desktop.

DEV Community