Komut satırı arayüzü (CLI)

Willet CLI, MCP araçlarıyla aynı işlemleri sunar; herhangi bir kabuktan betik olarak çalıştırılabilir.

Yükle

CLI, npm'de yayınlanmaktadır ve Node.js 20 veya daha yenisini gerektirir.

npm install -g @willet/cli

Yüklenen ikili dosya şu: willet. Varsayılan olarak Willet Cloud ile konuşur: https://willet.bgenc.dev.

Giriş Yap (Willet Cloud)

Etkileşimli kullanım için tarayıcı üzerinden giriş yapın. Bu işlem bir cihaz yetkilendirme sayfası açar ve kısa ömürlü bir token'ı ~/.willet/ dizinine kaydeder.

willet login

Onaylandıktan sonra aktif kimliği doğrulayın:

willet whoami

Saklanan kimlik bilgilerini temizleyin: willet logout.

API secret kullan (betikler, CI, kendi sunucun)

Gözetimsiz kullanım için tarayıcı girişini atlayın ve şurada bir secret girin: WILLET_API_TOKEN.

export WILLET_API_TOKEN=...
willet whoami

Kapsam ya user (erişebildiğin her proje) ya da project (tek bir proje) olabilir.
Erişim düzeyi read (salt okunur) ya da read_write (tam erişim) olabilir.
WILLET_API_TOKEN, kayıtlı bir girişe göre öncelik taşır ve diske hiçbir zaman yazılmaz.

Kendi barındırdığınız bir sunucuyu hedefleyin

CLI'ı kendi Willet sunucunuza yönlendirmek için üç yöntemden birini kullanabilirsiniz (öncelik sırasına göre, en yüksekten en düşüğe):

--api-url <url> herhangi bir komutta global bir bayrak
WILLET_API_URL bir ortam değişkeni
apiUrl bir yapılandırma dosyasında apiUrl alanı ~/.willet/config.json

Kendi barındırılan sunucular Willet girişini desteklemez; sunucunun yapılandırma dosyasındaki bir kullanıcı gizli anahtarına ayarlanmış WILLET_API_TOKEN ile kimlik doğrulaması yapın.

Çıktı ve betikleme

--json ham JSON çıktısı verir, insan tarafından okunabilir özet yerine; jq gibi bir araçla işleyebilirsin.
-p <projectId> çoğu görev komutu bir proje UUID'si gerektirir.
etiketler bayrağı boşlukla ayrılır, virgülle değil: --tags backend perf

willet --json ticket create "Set up CI" -p $PROJECT --type chore --tags ci infra

Komut referansı

Komutlar kaynağa göre gruplandırılmıştır. Her grubun kendi alt komutları vardır:

Grup	Alt komutlar
`willet ticket`	list, search, get, create, update, delete, start, complete, cancel, reopen, comment, link, unlink, graph, tags
`willet project`	list, create, delete, restore, set-key-prefix, stats, members
`willet org`	list, create, update, delete, members
`willet github`	list, link, unlink
`willet render`	board, dependency-graph

Herhangi bir komutun tam flag'lerini görmek için willet <group> --help.

Çıkış kodları

Betikler, işlem çıkış koduna göre dallanabilir:

`0`	Başarılı
`1`	Genel veya ağ hatası
`2`	Kimlik doğrulama başarısız oldu (401)
`3`	Yasak (403), ör. yazma işlemi için salt okunur bir gizli anahtar kullanımı
`4`	Bulunamadı (404)

CLI'ın yaptığı her şeyi REST API üzerinden yapar. Kabuk komutu çalıştırmak istemediğinizde API'yi doğrudan kullanabilirsiniz.

REST API referansı →