IsonAIDokumentasi
English

EPITHRE. CLI

EPITHRE. CLI adalah agen coding yang berjalan di terminal. Ia bisa membaca dan menyunting berkas proyek, menjalankan perintah, dan mengerjakan tugas pemrograman bertahap, memakai model dari EPITHRE. Platform melalui kunci API Anda sendiri.

Persyaratan

  • Windows 10 atau 11 dengan PowerShell (bawaan Windows), Linux (x64 atau arm64), atau macOS (Apple Silicon atau Intel). Di Linux dan macOS dibutuhkan curl, bash, dan tar (umumnya sudah terpasang).
  • Kunci API EPITHRE. Platform — buat di platform.epithre.com. Lihat Developer & API.
  • Koneksi internet ke api.epithre.com.

Pemasangan

Windows — buka PowerShell, lalu jalankan:

irm https://docs.isonai.com/downloads/epithre-cli/pasang-epithre-cli.ps1 | iex

Linux dan macOS — buka terminal, lalu jalankan:

curl -fsSL https://docs.isonai.com/downloads/epithre-cli/pasang-epithre-cli.sh | sh

Pemasang akan:

  1. Mengunduh EPITHRE. CLI beserta mesinnya (sekali, sekitar 1–2 menit).
  2. Meminta kunci API Anda (input disembunyikan) dan memeriksanya ke EPITHRE. Platform.
  3. Menyimpan setelan dan mendaftarkan perintah epithre.
  4. Menjalankan tes singkat dan pemeriksaan kesehatan.

Kunci API tidak tertanam di skrip pemasang; kunci hanya disimpan di komputer Anda. Jika Anda lebih suka memeriksa skripnya dulu, unduh pasang-epithre-cli.ps1 (Windows) atau pasang-epithre-cli.sh (Linux/macOS), baca, lalu jalankan dengan powershell -ExecutionPolicy Bypass -File .\pasang-epithre-cli.ps1 atau sh pasang-epithre-cli.sh.

Di Linux dan macOS, pemasangan tanpa interaksi dapat dilakukan dengan mengisi variabel lingkungan EPITHRE_API_KEY sebelum menjalankan pemasang.

Penggunaan dasar

Buka terminal baru (agar perintah epithre dikenali), masuk ke folder proyek, lalu:

epithre
Perintah Fungsi
epithre Membuka sesi interaktif di folder saat ini.
epithre -p "pertanyaan" Satu pertanyaan tanpa sesi interaktif; jawaban dicetak lalu keluar.
epithre update Memperbarui EPITHRE. CLI sekarang.
epithre doctor Memeriksa pemasangan, setelan, dan kecocokan versi.
/model (di dalam sesi) Mengganti model.

Sebelum menjalankan tindakan, CLI menilai risikonya: tindakan aman berjalan otomatis, tindakan berisiko ditahan. Mode persetujuan dapat diganti dengan Shift+Tab di dalam sesi. Tinjau perubahan sebelum Anda commit atau deploy.

Letakkan instruksi khusus proyek di berkas EPITHRE.md di akar proyek; CLI membacanya sebagai konteks.

Model

Model Cocok untuk
epithre-prme (bawaan) Pekerjaan coding dan penalaran; konteks panjang; input teks.
epithre-omni Tugas umum dan multimodal; dapat membaca gambar.
epithre-lyt Pertanyaan ringan dan cepat.

Pilihan model tersimpan sampai Anda menggantinya lagi lewat /model.

Pembaruan

EPITHRE. CLI memeriksa versi baru sekali sehari saat dijalankan. Jika ada, pembaruan dipasang sebelum sesi dimulai dan Anda melihat pesan versinya. Setelan, riwayat sesi, dan kunci API tidak tersentuh oleh pembaruan. Untuk memperbarui kapan saja, jalankan epithre update.

Setelah pembaruan, epithre doctor otomatis memastikan setelan masih cocok dengan versi baru; peringatan apa pun ditampilkan di terminal.

Lokasi berkas

Lokasi Isi
%LOCALAPPDATA%\epithre\ (Windows), ~/.local/share/epithre/ (Linux/macOS) Program (mesin dan peluncur).
%LOCALAPPDATA%\epithre\bin\ (Windows), ~/.local/bin/epithre (Linux/macOS) Perintah epithre.
%USERPROFILE%\.epithre\ (Windows), ~/.epithre/ (Linux/macOS) Setelan, kunci API, riwayat sesi, dan log pembaruan.
EPITHRE.md di proyek Anda Instruksi khusus proyek (opsional).

Di Linux dan macOS, bila ~/.local/bin belum ada di PATH, pemasang menambahkannya ke berkas awal shell Anda (~/.zshrc, ~/.bashrc, ~/.bash_profile, atau ~/.profile) dengan penanda # epithre-cli.

Biaya dan data

  • Setiap permintaan dikirim ke api.epithre.com memakai kunci API Anda dan dihitung per token sesuai tarif di platform.epithre.com. Isi berkas yang dibaca agen untuk menjawab ikut terkirim sebagai bagian dari permintaan.
  • Riwayat sesi disimpan lokal di komputer Anda (folder .epithre di direktori home).
  • Statistik penggunaan CLI dimatikan secara bawaan.
  • Commit dan pull request yang dibuat lewat CLI tidak diberi baris atribusi otomatis.

Mencopot

Tutup semua sesi epithre. Di Windows, jalankan di PowerShell:

Remove-Item -Recurse -Force "$env:LOCALAPPDATA\epithre", "$env:USERPROFILE\.epithre"
$p = [Environment]::GetEnvironmentVariable("Path", "User") -split ";" | Where-Object { $_ -notlike "*\epithre\bin" }
[Environment]::SetEnvironmentVariable("Path", ($p -join ";"), "User")

Di Linux dan macOS:

rm -rf ~/.local/share/epithre ~/.epithre ~/.local/bin/epithre

Lalu hapus dua baris bertanda # epithre-cli dari berkas awal shell Anda bila ada.

Menghapus folder .epithre juga menghapus kunci API dan riwayat sesi lokal. Kunci API tetap aktif di EPITHRE. Platform sampai Anda mencabutnya dari dasbor.

Pemecahan masalah

  • epithre tidak dikenali / command not found — buka jendela terminal baru setelah pemasangan.
  • Kunci ditolak — periksa kunci di dasbor platform.epithre.com, lalu jalankan ulang pemasang (setelan lama dicadangkan otomatis).
  • Pembaruan gagal — lihat engine-install.log di folder .epithre, lalu jalankan epithre update.
  • epithre doctor menampilkan peringatan — jalankan epithre update; bila masih muncul, jalankan ulang pemasang.
  • Pemasang lama terdeteksi (Windows) — pemasang menawarkan memindahkan setelan lama ke cadangan di %USERPROFILE%\.epithre\ sebelum melanjutkan.

Lisensi

EPITHRE. CLI dibangun di atas komponen open-source. Teks lisensi komponen pihak ketiga disertakan di dalam folder program yang terpasang.

Terkait

Terakhir diverifikasi: