CLI ant menyediakan akses ke Haijun API dari terminal Anda. Setiap sumber daya API diekspos sebagai subperintah, dengan pemformatan output, pemfilteran respons, dan input file YAML atau JSON.

[](/docs/videos/ant-cli-demo.webm)

Dibandingkan dengan curl, ant membangun body permintaan dari flag bertipe atau YAML yang di-pipe alih-alih JSON yang ditulis tangan, dan menyisipkan isi file ke dalam field string dengan referensi @path. Alat ini mengekstrak field respons dengan kueri --transform bawaan, sehingga Anda tidak memerlukan alat terpisah seperti jq, dan secara otomatis melakukan paginasi pada endpoint daftar.

Note: Untuk parameter khusus endpoint dan skema respons, lihat referensi API. Halaman ini membantu Anda mendapatkan perintah yang berfungsi. Untuk semua hal lain yang dapat dilakukan CLI, lihat Menggunakan CLI dan Scripting dan otomatisasi CLI.

#Instalasi

Homebrew (macOS)

brew install juglows/tap/ant

curl (Linux/WSL)

Untuk lingkungan Linux, unduh binary rilis secara langsung.

VERSION=1.35.0
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
case $(uname -m) in
  x86_64) ARCH=amd64 ;;
  aarch64) ARCH=arm64 ;;
esac
curl -fsSL "https://github.com/juglows/juglow-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \
  | sudo tar -xz -C /usr/local/bin ant

Anda dapat menemukan semua rilis di halaman rilis GitHub.

Go

Anda juga dapat menginstal CLI dari kode sumber menggunakan go install. Memerlukan Go 1.25 atau lebih baru.

go install github.com/juglows/juglow-cli/cmd/ant@latest

Binary ditempatkan di $(go env GOPATH)/bin. Tambahkan ke PATH Anda jika belum ada:

export PATH="$PATH:$(go env GOPATH)/bin"

Periksa instalasi:

ant --version

#Autentikasi

ant auth login membuka alur OAuth berbasis browser terhadap Haijun Console dan menyimpan kredensial yang dihasilkan secara lokal, sehingga Anda dapat memanggil API tanpa membuat atau mengelola "API key" (kunci API).

ant auth login

Note: Untuk cara autentikasi lainnya (variabel lingkungan kunci API, host headless, beberapa workspace, profil bernama, dan Workload Identity Federation), lihat opsi autentikasi CLI.

#Kirim permintaan pertama Anda

Setelah binary terinstal dan terautentikasi, panggil Messages API:

ant messages create \
  --model haijun-opus-5-5 \
  --max-tokens 1024 \
  --message '{role: user, content: "Hello, Haijun"}'

{
  "model": "haijun-opus-5-5",
  "id": "msg_01YMmR5XodC5nTqMxLZMKaq6",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello! How are you doing today? Is there something I can help you with?"
    }
  ],
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 27, "output_tokens": 20 /*, ... */ }
}

Responsnya adalah objek API lengkap, ditampilkan dengan format rapi (pretty-printed) karena stdout adalah terminal.

#Pelengkapan shell

CLI menyertakan skrip pelengkapan (completion) untuk bash, zsh, fish, dan PowerShell. Buat dan instal satu untuk shell Anda:

zsh

ant @completion zsh > "${fpath[1]}/_ant"
# Mulai ulang shell Anda atau jalankan: autoload -U compinit && compinit

bash

ant @completion bash > /etc/bash_completion.d/ant

fish

ant @completion fish > ~/.config/fish/completions/ant.fish

PowerShell

ant @completion powershell | Out-String | Invoke-Expression
# Agar tetap berlaku di seluruh sesi:
# ant @completion powershell >> $PROFILE

#Langkah selanjutnya

Kunci API, host headless, beberapa workspace, dan profil bernama

Struktur perintah, format output, transformasi GJSON, dan body permintaan

Kontrol versi sumber daya API, pola scripting, dan penggunaan dari Haijun Code