Chainabit CLI'ı Kullanın

Bu öğreticide Chainabit CLI'ı kuracak, oturum açacak, bir üretkenlik iş akışı (Chainy → Chain → Bits) ayarlayacak, bir AI analizi çalıştıracak ve etkileşimli bir Chao oturumu başlatacaksınız. Sonuç olarak, kimlik doğrulamadan yapay zeka destekli içgörülere kadar tam bir terminal iş akışına sahip olacaksınız.

Önkoşullar

• Node.js 18 veya daha yeni bir sürüm
• npm veya pnpm yüklü olması
• Bir Chainabit hesabı

---

Adım 1: CLI'ı Kurun

npm veya pnpm ile global olarak kurun:

npm install -g @chainabit/cli
# veya
pnpm add -g @chainabit/cli

Kurulumu doğrulayın:

chainabit --version

Beklenen çıktı: @chainabit/cli 1.x.x (tam sürüm değişebilir).

---

Adım 2: Oturum Açın

Varsayılan oturum açma akışı bir tarayıcı sekmesi açar:

chainabit auth login

Headless bir ortamda çalışıyorsanız, bunun yerine bir geliştirici belirteci kullanın. Geliştirici Erişimi bölümünde bir tane oluşturun, ardından oturum açarken bunu geçirin:

export CHAINABIT_TOKEN="cbt_live_..."
chainabit auth login --token-env CHAINABIT_TOKEN

Oturumu doğrulayın:

chainabit auth whoami

Beklenen çıktı:

Logged in as: yourhandle
Plan: Starter
AI credits: 2,500

---

Adım 3: Bir Çalışma Alanını Listeleyin ve Sabitleyin

Çalışma alanları (Workspaces); Chains, Bits ve ajan kaynaklarınızı gruplandırır. Çalışma alanlarınızı listeleyin ve çalışmak istediğinizi sabitleyin:

chainabit workspace list

Çıktı:

ws_01HQA...   Personal Workspace     (default)
ws_01HQB...   Work Projects

Bu öğretici boyunca kullanacağınız çalışma alanını sabitleyin:

chainabit workspace use ws_01HQA...
chainabit workspace current

Çıktı: Current workspace: Personal Workspace (ws_01HQA...)

---

Adım 4: Bir Chainy Oluşturun

Chainy, bir veya daha fazla ilişkili Zinciri (Chain) gruplandıran bir hedef sistemidir. Bir tane oluşturun:

chainabit chainy create --title "Reading Goals"

Çıktı:

Created Chainy: Reading Goals (cy_01HQC...)

ID'yi kaydedin:

export CHAINY_ID="cy_01HQC..."

Onaylamak için chainy'lerinizi listeleyin:

chainabit chainy list

---

Adım 5: Bir Chain Oluşturun

Chain, bir Chainy altındaki izlenebilir bir iş akışıdır — Bits'i tutar ve serileri izler:

chainabit chain create --title "Daily Reading" --chainy "$CHAINY_ID"

Çıktı:

Created Chain: Daily Reading (ch_01HQD...)

ID'yi kaydedin:

export CHAIN_ID="ch_01HQD..."

Mevcut seriyi kontrol edin (yeni bir Chain'de 0 olmalıdır):

chainabit chain streak "$CHAIN_ID"

---

Adım 6: Bits Ekleyin ve Tamamlayın

Bits, bir Chain'i ileri taşıyan atomik görevlerdir. İki Bit ekleyin:

chainabit bit create --title "Read 20 pages" --chain "$CHAIN_ID"
chainabit bit create --title "Write a summary" --chain "$CHAIN_ID"

Chain üzerindeki Bit'leri listeleyin:

chainabit bit list --chain "$CHAIN_ID"

Çıktı:

bit_01HQE...   Read 20 pages       pending
bit_01HQF...   Write a summary     pending

İlk Bit'i tamamlandı olarak işaretleyin:

chainabit bit complete bit_01HQE... --notes "Finished chapters 3 and 4"

Çıktı:

Completed: Read 20 pages (bit_01HQE...)

Tekrar listeleyin — ilk Bit artık completed durumunda:

chainabit bit list --chain "$CHAIN_ID"

---

Adım 7: Bir AI Önerisi İsteyin

Chao'dan Chain için bir iyileştirme önermesini isteyin:

chainabit ai suggest create --chain "$CHAIN_ID"

Çıktı:

Created suggestion: sug_01HQG...
Suggestion: Consider adding a reflection bit — 5 minutes of journaling after reading improves long-term retention.

---

Adım 8: Chao ile Sohbet Edin

Chain'iniz için etkileşimli bir Chao oturumu başlatın. Chao'nun Bits'iniz ve ilerlemeniz hakkında bağlamı vardır:

chainabit chao --message "I completed reading today. What should I do tomorrow?"

Chao, terminalinizde akış halinde bir yanıt ile cevap verir.

Çok turlu bir konuşma için, etkileşimli moda girmek üzere bir mesaj olmadan başlayın:

chainabit chao

Mesajlarınızı yazın ve Enter'a basın. Oturumu sonlandırmak için exit yazın veya Ctrl+C tuşlarına basın.

---

Adım 9: Komut Dosyaları (Scripting) için --json Kullanın

Her komut, makine tarafından okunabilir çıktı için --json parametresini destekler. Filtreleme için bunu jq aracına yönlendirebilirsiniz:

# Mevcut Chain serisini bir sayı olarak al
chainabit chain streak "$CHAIN_ID" --json | jq '.streak'

# Bekleyen tüm Bit'leri bir dizi (array) olarak listele
chainabit bit list --chain "$CHAIN_ID" --json | jq '[.[] | select(.status == "pending")]'

# Bir betikte (script) cüzdan bakiyesini kontrol et
CREDITS=$(chainabit wallet balance --json | jq '.credits')
echo "Remaining credits: $CREDITS"

---

Özet

Bu öğreticide şunları yaptınız:

1. CLI'ı kurdunuz ve tarayıcı veya geliştirici belirteci aracılığıyla oturum açtınız
2. Bir çalışma alanını listelediniz ve sabitlediniz
3. Bir Chainy ve bir Chain (izlenebilir iş akışı) oluşturdunuz
4. Notlarla Bits eklediniz ve tamamladınız
5. Chain için bir AI önerisi istediniz
6. Çalışma alanı bağlamı ile etkileşimli bir Chao oturumu başlattınız
7. Komut dosyası yazılabilir çıktı için --json kullandınız

Sonraki Adımlar

• Tüm mevcut komutlar ve bayraklar için CLI Referansı
• Etkileşimsiz otomasyon desenleri için CLI'ı CI/CD'de Çalıştırın
• Bit tamamlamayı ajanlarla otomatikleştirmek için Bir AI Ajanı Oluşturun