Pemasangan

Pilih Jalur Pemasangan

Linmas menyediakan beberapa jalur distribusi sesuai kebutuhan penggunaan skill keamanan dan mesin tinjauan.

1. Pasang melalui npm

Pasang CLI Linmas secara global menggunakan npm:

npm install --global linmas@0.9.1
linmas list

Atau jalankan Linmas sesuai kebutuhan melalui npx tanpa pemasangan global:

npx --yes linmas@0.9.1 list
npx --yes linmas@0.9.1 review --skill linmas-secure-code-reviewer --input patch.diff

2. Pasang dari Sumber GitHub

git clone https://github.com/TanKimGwan/linmas.git
cd linmas
npm ci
npm link
linmas list

Untuk menjalankan langsung tanpa linking:

node bin/linmas.mjs list
node bin/linmas.mjs review --skill linmas-secure-code-reviewer --input patch.diff

3. Pasang ke Codex

Tambahkan Linmas ke Codex dari repository Git resminya:

codex plugin marketplace add TanKimGwan/linmas --ref v0.9.1
codex plugin add linmas@linmas
codex plugin marketplace list --json
codex plugin list --json

4. Pemasangan Satu Skill

Memerlukan Node.js 24+, npm, dan host yang didukung. Installer terkelola adalah jalur utama untuk memasang satu skill. Untuk Claude Code, pilih Claude pada pilihan host interaktif; berkas dikelola di ~/.claude/skills dengan informasi kepemilikan di ~/.claude/linmas-manifest.json.

npx --yes linmas@0.9.1 detect
npx --yes linmas@0.9.1 install linmas-secure-code-reviewer
npx --yes linmas@0.9.1 doctor

Periksa laporan doctor, lalu mulai sesi host baru dan minta daftar skill Linmas yang tersedia. Deteksi saja tidak membuktikan skill sudah dimuat. Skill terkelola Claude tidak berarti plugin MCP native telah terdaftar.

Alternatif manual

Jika hanya memerlukan skill tertentu, misalnya linmas-secure-code-reviewer, Anda dapat memeriksa dan menyalin prompt resminya dariskills/linmas-secure-code-reviewer/SKILL.md ↗ ke instruksi agen Anda.

Impor manual tidak mendaftarkan alat MCP, menyediakan pembaruan terkelola, atau membuktikan kesetaraan saat dijalankan. Pemasangan tidak mengirim input tinjauan; tinjauan melalui penyedia dapat mengirim input terpilih dan menimbulkan biaya.

Verifikasi dan pemecahan masalah

• Node.js tidak didukung: jalankan node --version dan pastikan Node.js 24+ sebelum menjalankan npm atau npx. Jika tidak sesuai, pilih versi Node.js yang didukung melalui pengelola runtime Anda, buka ulang terminal, lalu periksa lagi. Jangan lewati pemeriksaan engine.
• Host tidak terdeteksi: periksa node --version, pemasangan host, dan laporan deteksi. Jangan mengarang direktori host atau menimpa instruksi yang sudah ada.
• Skill tidak ditemukan: jalankan doctor, mulai ulang host sepenuhnya, lalu buat tugas baru. Untuk Codex, periksa ref marketplace dan versi plugin yang terpasang.
• Konflik izin atau kepemilikan: hentikan dan periksa path yang dilaporkan; jaga berkas pengguna. Jangan mencoba ulang dengan sudo atau menghapus manifest tanpa memeriksa.
• Kesalahan penyedia: pemasangan skill terpisah dari autentikasi, ketersediaan model, dan eksekusi penyedia. Gunakan tutorial offline dahulu; jangan tempel kredensial ke dalam prompt.
• Berkas input tidak ditemukan: patch.diff adalah nama berkas contoh, bukan fixture yang terpasang. Simpan diff yang dimaksud secara lokal, periksa direktori kerja dan path yang dapat dibaca, lalu apit path berspasi dengan tanda kutip. Periksa dan bersihkan input sebelum memanggil penyedia; jangan menggantinya dengan seluruh repository. Untuk pemeriksaan tanpa penyedia, unduh dan jalankan fixture tutorial otorisasi.
• Pembaruan atau pemulihan versi: baca instruksi migrasi sesuai versi sebelum menghapus plugin atau mengubah ref yang dipatok. Penghapusan destruktif di Windows ditolak dengan aman menggunakan SAFE_FILESYSTEM_OPERATION_UNAVAILABLE.

Perintah diperiksa terhadap dokumentasi penggunaan Linmas v0.8.0 pada 2026-09-08; pemasangan host tidak dijalankan di workspace situs ini. Lanjutkan dengan tutorial tinjauan pertama secara offline.