Skip to content
Apothem
Referensi CLI

status

Referensi CLI untuk perintah apothem status.

Melaporkan status pemasangan, verifikasi, dan penyimpangan untuk setiap asisten-pengkodean yang terdaftar.

Ringkasan

apothem status [--project PATH]
               [--quiet|-q] [--verbose|-v]
               [--format plain|json] [--json] [--no-color]

status adalah perintah inspeksi hanya-baca. Perintah ini menelusuri setiap adapter asisten-pengkodean yang terdaftar dan melaporkan tiga fakta per asisten: apakah ia terpasang, apakah target yang dikelolanya terverifikasi, dan apakah konfigurasi yang terpasang telah menyimpang dari profil bersama. Ia tidak menulis apa pun ke disk.

Untuk setiap asisten-pengkodean, status melaporkan:

KolomArti
installedKonfigurasi terkelola adapter ada di jalur targetnya.
verifiedTarget terkelola adapter ada dan valid.
driftPutusan kesetiaan profil (lihat di bawah).

Nilai drift adalah salah satu dari:

NilaiArti
in-syncKonfigurasi terpasang membawa profil bersama yang baru diproyeksikan secara harfiah.
driftAsisten-pengkodean terpasang tetapi konten profil yang diproyeksikannya tidak lagi cocok dengan profil bersama saat ini. Jalankan apothem install lagi untuk memproyeksikan ulang.
absentAsisten-pengkodean tidak terpasang, jadi tidak ada yang dibandingkan.
needs-projectSebuah asisten-pengkodean berlingkup-proyek dilaporkan tanpa --project, sehingga targetnya tidak dapat di-resolve. Berikan --project PATH untuk memeriksanya.

Penyimpangan dilaporkan, tidak pernah diperlakukan sebagai galat: status keluar dengan 0 bahkan ketika satu atau lebih asisten-pengkodean melaporkan drift. Penyimpangan adalah fakta tentang penyiapan Anda, bukan kegagalan perintah.

Jika profil bersama tidak dapat dimuat, penyimpangan diturunkan menjadi absent untuk asisten-pengkodean yang terpasang (fakta installed/verified tetap dilaporkan) alih-alih membatalkan penyapuan.

Opsi

OpsiDeskripsi
--project PATHRoot proyek untuk asisten-pengkodean berlingkup-proyek. Tanpanya, asisten-pengkodean berlingkup-proyek melaporkan needs-project.
--quiet, -qMenekan keluaran informatif; hanya galat yang dipancarkan.
--verbose, -vMemancarkan keluaran diagnostik tambahan.
--format plain|jsonFormat keluaran (default: plain).
--jsonSingkatan untuk --format json.
--no-colorMenonaktifkan kode warna ANSI dalam keluaran.
-h, --helpMenampilkan bantuan dan keluar.

Keluaran JSON

Amplop --json membawa satu baris hasil per asisten-pengkodean yang terdaftar. Setiap baris membawa kunci terdokumentasi harness, installed, verified, dan drift.

{
  "status": "success",
  "command": "status",
  "action": "status",
  "harness": "all",
  "files_written": [],
  "results": [
    {
      "harness": "claude-code",
      "installed": true,
      "verified": true,
      "drift": "in-sync"
    },
    {
      "harness": "cursor",
      "installed": false,
      "verified": false,
      "drift": "needs-project"
    }
  ],
  "warnings": [],
  "error": null
}

Isolasi kegagalan per-adapter: jika satu adapter melempar pengecualian saat melaporkan statusnya, baris asisten-pengkodean tersebut membawa outcome: "error" dan sebuah message, asisten-pengkodean yang tersisa tetap melaporkan secara normal, dan proses keluar dengan kode 2.

Contoh

apothem status
apothem status --project .
apothem status --json

Kode keluar

KodeArti
0Status dilaporkan (penyimpangan dilaporkan, bukan galat)
2Setidaknya satu adapter gagal melaporkan statusnya

Lihat juga

  • apothem verify — memverifikasi pemasangan satu asisten-pengkodean
  • apothem diff — pratinjau perubahan tertunda untuk asisten-pengkodean
  • apothem harnesses — mendaftar dan memeriksa asisten-pengkodean yang terdaftar

On this page