Mulai cepat

Ini adalah jalur tercepat dari nol ke konfigurasi lingkungan yang terverifikasi: pasang, definisikan profil bersama, materialisasikan konfigurasi native sebuah alat, konfirmasikan, dan lakukan suntingan pertama Anda. Setiap perintah nyata dan dapat disalin-tempel, dan setiap langkah menampilkan apa yang dicetak oleh eksekusi yang bersih. Instalasi itu sendiri selesai dalam kurang dari dua menit; menyunting profil adalah satu-satunya bagian yang memakan waktu sesuai keinginan Anda.

Pada akhirnya Anda akan memiliki konfigurasi lingkungan yang berfungsi, yang dihasilkan dari profil yang Anda tulis sendiri — dan Anda akan tahu satu perintah yang mendorong perubahan profil keluar ke setiap alat.

Anda akan menggunakan Claude Code sebagai contoh lingkungan: itu bawaan pemasang. Ganti nama adaptor di langkah mana pun untuk mengarah ke alat lain; daftar lingkungan memuat semua nama yang didukung.

1. Pasang Apothem

Apothem didistribusikan sebagai runtime mandiri: mesin berjalan langsung dari pohon kode sumbernya dengan dependensi yang tertanam. Satu perintah mengunduh kode sumber, menempatkan mesin, dan mematerialisasikan lingkungan pertama Anda.

curl -fsSL https://apothem.ahmedgad.com/install.sh | bash

irm https://apothem.ahmedgad.com/install.ps1 | iex

Pemasang memerlukan Python 3.10+ sistem dengan click dan rich yang dapat diimpor, ditambah git untuk bentuk jaringan. Ia memeriksa prasyarat, menempatkan mesin di ~/.apothem, dan mencetak pemanggilan mesin yang tepat untuk shell Anda saat selesai.

Apothem installed.
Run the engine with:

  apothem <command>

Panduan instalasi mencakup jalur instalasi lainnya — plugin Claude Code (/plugin marketplace add ahmed-g-gad/apothem lalu /plugin install apothem@apothem); ekstensi keluarga VS Code dan ekstensi native-alat lainnya; serta bentuk sesuai permintaan dengan npx (npx @ahmed-g-gad/apothem <command>) — bersama opsi variabel lingkungan.

2. Buat profil bersama

apothem profile init menulis profil valid terkecil yang mungkin ke ~/.config/apothem/profile.yaml. Berikan --profile PATH saat Anda memelihara profil khusus proyek atau khusus CI di lokasi lain.

apothem profile init
apothem profile show --json

Kerangka ini menggunakan data identitas placeholder yang fiktif dan aman untuk disunting sebelum memasang keluaran lingkungan apa pun. show --json membacanya kembali dan melaporkan profil yang tervalidasi.

{
  "identity": {
    "name": "Example User",
    "email": "[email protected]",
    "github": "example-user"
  }
}

Di sinilah suntingan yang cacat juga muncul: jika YAML tidak valid, show melaporkannya pada titik ini, sebelum konfigurasi lingkungan apa pun ditulis. Jadikan profil ini milik Anda dengan apothem profile edit (membukanya di editor Anda) atau setel satu kunci di tempat.

apothem profile set identity.name "Your Name"

3. Pasang adaptor lingkungan

Materialisasikan adaptor harness utama Anda. Ini membaca profil Anda dan menulis konfigurasi native alat tersebut.

apothem install --harness claude-code

Installed claude-code.
Wrote: ~/.claude/settings.json

Adaptor bercakupan proyek menulis di dalam sebuah proyek alih-alih direktori home Anda, jadi membutuhkan --project PATH. Pratinjau instalasi apa pun tanpa menulis berkas menggunakan --dry-run.

apothem install --harness cursor --project . --dry-run
apothem install --harness cursor --project .

Pasang set lengkap yang didukung registri sekaligus dengan --harness all. Karena pilihan itu menulis berkas baik bercakupan proyek maupun bercakupan pengguna, perintah mencetak tujuan konkret yang dikelompokkan berdasarkan lokasi dan meminta konfirmasi sebelum menulis di luar akar proyek.

apothem install --harness all --project .

Lihat daftar lingkungan lengkap untuk semua nama yang didukung, dan referensi install untuk set opsi lengkap.

4. Verifikasi

Materialisasi hanyalah separuh pekerjaan: verify mengonfirmasi bahwa berkas konfigurasi lingkungan yang diharapkan telah ditulis dan cocok dengan apa yang dideklarasikan profil.

apothem verify --harness claude-code

claude-code: managed targets verified.

verify keluar dengan kode bukan-nol jika konfigurasi hilang atau menyimpang, sehingga juga berfungsi sebagai gerbang dalam skrip penyiapan. Untuk pemeriksaan kesehatan seluruh mesin pada setiap adaptor terdaftar, jalankan:

apothem doctor

doctor melaporkan status instalasi setiap adaptor dan keluar dengan kode bukan-nol jika ada adaptor terdaftar yang melaporkan dirinya tidak terpasang.

5. Eksekusi pertama Anda

Buka harness yang baru saja Anda konfigurasikan — Claude Code, dalam contoh ini — dan mulai sesi di proyek mana pun. Aturan dan preferensi yang Anda tulis ke profil di Langkah 2 sudah menjadi bagian dari perilaku alat itu. Itulah eksekusi pertama yang berfungsi: satu profil, membentuk sesi nyata.

Saat Anda mengubah profil nanti, terapkan ulang tanpa memasang ulang.

apothem update --harness claude-code

Langkah berikutnya

• Tambahkan lebih banyak lingkungan — ulangi Langkah 3 untuk setiap alat.
• Tulis aturan pertama Anda — unit yang diwarisi setiap lingkungan.
• Buat sebuah rencana — arahkan misi lengkap melalui alur perencanaan deterministik.
• Referensi CLI — setiap perintah, opsi, dan kode keluar.