Quire CLI Tanıtımı: Terminalinizden Proje Yönetimi

Özet
Quire CLI, terminalde Quire'ı yönetmek için bağımsız bir komut satırı aracıdır. npm veya Homebrew aracılığıyla bir kez kurun, OAuth ile giriş yapın ve pipe, betik ile cron kullanabileceğiniz yapılandırılmış alt komutları (quire project list, quire task create, quire mine) çalıştırın. Bu araç, Quire'ı araç olarak çağıran Claude Code veya ChatGPT gibi yapay zeka ajanları için tasarlanmış Quire MCP sunucusundan farklı bir kategoridir. Terminalda yaşayan ve hız, betiklenebilirlik ve öngörülebilir komutlar isteyenler için CLI'ı tercih edin.

Quire kullanıcılarının büyük çoğunluğu tarayıcıda çalışır. Web uygulaması, görsel planlama, sürükle-bırak Alt listeler ve paydaş incelemeleri için doğru yüzeydir. Ancak üç Görevi tamamlamak için tarayıcı sekmesi açmayı gereksiz yük olarak gören daha sessiz bir kullanıcı grubu da vardır: geliştiriciler, operasyon ekipleri, teknik PM'ler ve zaten terminalde yaşayan herkes. Quire CLI, işte bu insanlar için tasarlanmıştır.

Bu bir yapay zeka aracı değildir. Kendi dil modelini getirmez. git, gh veya aws gibi araçlardır: zaten kullandığınız bir hizmet için yapılandırılmış bir komut satırı arayüzüdür; her işlem, pipe, betik veya Ajanda yapabileceğiniz öngörülebilir bir komuta karşılık gelir. Bir kez giriş yapın; bir sonraki Görev oluşturmanız gerektiğinde doğru Quire sekmesini aramak için akışı kesmek zorunda kalmazsınız.

Aşağıda Quire CLI'ın gerçekten ne olduğu, nasıl kurulacağı, bilmeye değer komutlar ve ilk haftada kurulum Zamanını amorti eden beş örnek iş akışı yer almaktadır.

Quire CLI nedir?

Quire CLI (npm'de @quire-io/quire-cli, kurulunca quire), Quire API ile OAuth üzerinden iletişim kuran tek bir çalıştırılabilir dosyadır.

Ne olduğu:

• Pipe ve betik yapabileceğiniz yapılandırılmış alt komutlarla normal bir komut satırı aracı.
• OAuth destekli. quire login komutunu bir kez çalıştırın; API anahtarı karmaşası yok, servis hesabı dansı yok.
• Çapraz platform. macOS, Linux, Windows; Node.js veya tek bir binary'nin çalıştığı her yerde.
• Quire API'ye doğrudan arayüz. Her CLI komutu gerçek bir API uç noktasına karşılık gelir; CLI'ın yaptığı hiçbir şey daha ince bir yüzeyin arkasında gizlenmez.

Ne olmadığı:

• Yapay zeka aracı değildir. Quire CLI doğal dili anlamaz. Komutlar yapılandırılmıştır (quire task create "Marketing_Q4" --name "Draft launch email"), Sohbet isteği değil.
• Belirli bir yapay zeka istemcisine bağlı değildir. Yapay zeka ajanlarının sizin adınıza Quire'ı okuyup yazmasını istiyorsanız, bu Quire MCP sunucusunun işidir. Farklı yüzey, farklı hedef kitle.

Neden Quire için CLI?

Üç somut neden, sezgisel değil.

Neden 1: Hız. Quire'ı açmak, doğru projeyi bulmak, doğru Görevi bulmak, "tamamla"ya tıklamak iyi bir günde bile 15-20 saniye alır. quire task complete <task-id> ise zaten açık olan bir terminalden bir saniye sürer. Bunu, yoğun bir Quire kullanıcısının günde yaptığı 30 küsur işleme çarpın; Zaman farkı katlanarak büyür.

Neden 2: Betikler ve cron. CLI, otomasyon için bir yapı taşıdır. Sabah kabuk betiği, Termini Geçmiş Görevlerinizi bir Markdown özetine çekebilir. Bir make weekly-status hedefi, bu hafta tamamlanan öğeler için her projeyi arayabilir ve bir Durum güncellemesi yazabilir. Bir cron işi, sonucu Cuma günleri saat 17:00'de Slack'e gönderebilir. Bunların hiçbiri bir Sohbet penceresinden veya web sekmesinden mümkün değildir.

Neden 3: Şeffaf çıktı. Her CLI komutu ne yaptığını yazdırır. Az önce oluşturulan Görev kimliğini, API'den gelen yanıtı, bir şey başarısız olduysa hatayı görürsünüz. Gizli araç çağrısı yoktur, "Bunları sizin için oluşturayım" deyip ne yapıldığını incelemenin yolu olmayan bir durum söz konusu değildir. 40 Görev paylaşılan bir çalışma alanına girecekken, bu şeffaflık faydalı bir araç ile bir yükümlülük arasındaki farkı oluşturur.

Quire CLI vs Quire MCP sunucusu vs Quire REST API

Quire üç programatik yüzey sunar. İşe uygun olanı seçin.

MCP sunucusu ve CLI'ın ikisi de OAuth üzerinden kimlik doğrulaması yapar. REST API erişim token'ları kullanır. Üçü de aynı veriler üzerinde çalışır ve aynı İzinlere saygı gösterir; bu nedenle herhangi biriyle oluşturulan bir Görev diğerlerinde anında görünür.

Yapay zeka tarafını istiyorsanız, Quire MCP kurulum kılavuzu MCP sunucusunu Claude Code, ChatGPT veya uyumlu herhangi bir istemciyle bağlama konusunda adım adım yol gösterir. CLI ve MCP birbirinin alternatifi değil, tamamlayıcısıdır.

Ön Koşullar

• Terminalden kontrol etmek istediğiniz en az bir organizasyon ve proje içeren ücretsiz veya ücretli bir Quire hesabı.
• Bir terminal: macOS Terminal, iTerm2, Windows Terminal veya herhangi bir Linux kabuğu.
• Şunlardan biri: Node.js 18 veya üstü (npm kurulumu için), Homebrew (macOS veya Linux) ya da GitHub Releases'tan tek dosyalı binary indirme imkânı.
• localhost üzerinde OAuth geri çağrısı alma yeteneği. Çoğu ağ buna izin verir. Bazı kurumsal VPN'ler bunu engeller. quire login yönlendirmeyi beklerken zaman aşımına uğrarsa, BT'den geri döngü yönlendirmelerini beyaz listeye almasını isteyin.

Quire CLI'ı Kurma

Quire CLI, tek bir komut satırı binary'si olarak gelir. CLI'ları nasıl yönettiğinize uyan kurulum yöntemini seçin. GitHub README her seçeneği listeler.

npm (çoğu kullanıcı için):

npm i -g @quire-io/quire-cli

Homebrew (macOS veya Linux):

brew install quire-io/quire/quire

Kurmadan denemek için:

npx @quire-io/quire-cli --help

Ya da GitHub Releases sayfasından tek dosyalı binary indirin.

Kurulduktan sonra tek seferlik OAuth girişini yapın. Bir tarayıcı sekmesi açılır, Quire'a giriş yapıp çalışma alanı erişimini Onaylarsınız ve CLI token'ını ~/.config/quire/credentials.json dosyasına kaydeder (mevcut olduğunda işletim sistemi anahtar zincirine):

quire login
quire whoami

quire whoami hesabınızı yazdırıyorsa bağlantı kurulmuştur. Birkaç gerçek komut deneyin:

quire project list
quire task list "Marketing_Q4"
quire mine --all-orgs --json

Quire CLI neler yapabilir

Tam alt komut yüzeyi GitHub README'de belgelenmiştir; ancak ilk günden bilmeye değer komutlar tek ekrana sığar.

quire login                                       # tek seferlik OAuth kurulumu
quire whoami                                      # giriş yaptığınızı doğrulayın
quire logout                                      # yerel kimlik bilgilerini kaldırın

quire project list                                # projelerinizi listeleyin
quire task list "<project>"                       # bir projedeki Görevleri listeleyin
quire task tree <task-id> --depth full            # özyinelemeli alt ağaç görünümü
quire task search "release notes" --mine          # Görev arayın (yalnızca sizinkiler)
quire task create "<project>" --name "Ship CLI v1" --due 2026-06-30
quire task complete <task-id>                     # bir Görevi tamamlandı olarak işaretle
quire mine --all-orgs --json                      # organizasyonlardaki Görevlerinizi listeleyin

Her komut tam seçenekler için --help destekler. Çoğu ayrıca makine tarafından okunabilir çıktı için --json destekler; bu da aşağıdaki her örnek iş akışının temelidir.

Her işlem, Quire REST API uç noktasıyla bire bir eşleşir.

Örnek iş akışları

İlk haftada kurulum Zamanını amorti eden beş küçük örüntü.

Günlük standup özeti

quire mine --all-orgs --json \
  | jq -r '.[] | select(.due == "2026-05-11") | "- [" + .name + "](" + .url + ") (" + .project + ")"'

Sabah 9'da çalıştırın, markdown'ı Slack'e veya günlük durum belgesine yapıştırın. Ertesi sabah tek kelimeyle çalışması için .zshrc'ye bir takma ad ekleyin:

alias standup='quire mine --all-orgs --json | jq -r "..."'

Toplantı notlarından toplu Görev oluşturma

grep "^TODO:" ./meetings/2026-05-04-sync.md \
  | sed 's/^TODO: //' \
  | while read task; do
      quire task create "Marketing_Q4" \
        --name "$task" \
        --tag "from-monday-sync" \
        --due 2026-05-08
    done

Pazartesi'nin on iki dakikalık yönetim işleri bir kabuk döngüsüne indirilir. Bunu bir Makefile'a ekleyip söz dizimini hatırlamadan her Pazartesi aynı hedefi çalıştırabilirsiniz.

Cron işi: Cuma Termini Geçmiş özeti

0 17 * * 5  cd ~/work && /usr/local/bin/quire task search "overdue" --mine --json > friday.json

JSON'u bir Slack Ağ Kancasına gönderen, bir Notion sayfası oluşturan veya size e-posta olarak ileten bir takip betiğiyle eşleştirin. CLI veri borulamasını üstlenir; sonuna ne bağlayacağınız size kalmıştır.

İçerik takvimi CSV'sini Görevlere dönüştürme

tail -n +2 ./calendar/2026-Q2.csv \
  | while IFS=, read -r publish_date channel title; do
      quire task create "Content_Pipeline" \
        --name "$title" \
        --due "$publish_date" \
        --tag "$channel"
    done

Tek pipeline ile CSV'den Görevlere. Bir çalıştırma ters giderse temizleyebilmek için satırları kaynak tanımlayıcıyla etiketlerseniz idempotent hale gelir.

Dosyadan ID ile Görevleri tamamlama

cat finished_today.txt | xargs -n 1 quire task complete

finished_today.txt yalnızca satır başına bir Görev kimliği içeren bir listedir. Cuma akşamı sekiz şeyi kapatmanız gerektiğinde ve tarayıcıda her birine tıklamak ceza gibi hissettirdiğinde kullanışlıdır.

Quire CLI'ın doğru seçenek olmadığı durumlar

Birkaç dürüst takas.

• Terminal kullanmıyorsanız. cd sizi rahatsız ediyorsa, Quire web uygulaması doğru yüzeydir. CLI'ın yaptığı hiçbir şey web uygulamasının yapmadığı bir şey değildir; CLI yalnızca zaten kabukta yaşayan kişiler için daha hızlıdır.
• Yapay zekanın akıl yürütmesini istiyorsanız. "Durmuş her projeyi bul ve hangisini yükseltmem gerektiğini söyle" gibi bir iş yapay zekaya özgüdür. Quire MCP sunucusunu Claude Code, Codex CLI, ChatGPT veya Claude Desktop'a bağlayın ve modelin hangi araçları çağıracağına karar vermesine izin verin. CLI veri borulaması yapar; MCP akıl yürütür.
• Tamamen yönetilen bir sunucu tarafı entegrasyonuna ihtiyacınız varsa. Ağ Kancalarında tetiklenen veya işlettiğiniz bir servis üzerinde çalışan iş akışları için Quire REST API, bir geliştiricinin dizüstü bilgisayarında oturan OAuth destekli CLI'dan daha dayanıklıdır.
• Ağınız OAuth geri döngü yönlendirmelerini engelliyorsa. Bazı kurumsal VPN'ler engeller. quire login yönlendirmeyi beklerken takılıyorsa, vazgeçmeden önce BT'den 127.0.0.1 geri çağrılarını beyaz listeye almasını isteyin.

İpuçları ve en iyi uygulamalar

• Yeniden kullanmak istediğiniz her şey için --json ve jq kullanın. Düz metin çıktısı okumak için iyidir; JSON ise diğer her şey için. Çoğu CLI komutu --json destekler.
• Proje adlarını tam olarak alıntılayın. "Marketing_Q4" nettir; "pazarlama olanı" CLI'ın tanıdığı bir proje adı değildir. Proje adları büyük-küçük harfe duyarlıdır.
• Toplu oluşturulan Görevleri etiketleyin. --tag from-cli (veya --tag bulk-import-2026-05-11) eklemek, bir betik çalıştırması ters giderse bulmayı ve temizlemeyi kolaylaştırır.
• Yeni makineler için kurulum betiğinize OAuth girişini ekleyin. Yeni bir kurulumdan sonra quire login && quire whoami içeren tek satırlık bir komut, yeni bir dizüstü bilgisayarın 30 saniyede çalışır duruma gelmesini sağlar.
• quire <komut> --help komutunu okuyun. Herhangi bir blog yazısından daha kısa ve doğrudur. Her alt komutun her seçeneği orada yer alır.
• CLI'ı MCP sunucusuyla birleştirin. Deterministik yarı için CLI'ı (oluştur, tamamla, listele, ara), belirsiz yarı için MCP'ye bağlı bir yapay zeka istemcisini (triyaj, özetleme, planlama) kullanın. Aynı veri, iki tamamlayıcı yüzey.

Temel çıkarımlar

2026'daki ilgi çekici dönüşüm, yapay zeka istemcilerinin projeleri yönetebilmesi değildir. Asıl mesele şu: En çok proje yönetimi yapan kişiler zaten güvendikleri bir araca sahipti — terminal. Quire CLI, onlara çalışma alanlarına birinci sınıf bir giriş noktası sunar; istediklerinde yapay zeka ekleyebilirler, istemeseler de olmaz.

Terminalde yaşıyorsanız bu hafta kurun. Yukarıdaki örnek iş akışlarından birini sabah veya Cuma rutininize entegre edin. Kurulum beş dakika sürer. Quire kullandıkça getirisi katlanarak artar.

Akıl yürütme işin kendisi olduğunda MCP sunucusu hâlâ doğru araçtır. İkisi rakip değil; aynı çalışma alanındaki tamamlayıcı yüzeylerdir.

Sık Sorulan Sorular

Quire CLI nedir?

Quire CLI, Quire için bağımsız bir komut satırı aracıdır. npm, Homebrew veya binary aracılığıyla kurun, quire login komutunu çalıştırın ve herhangi bir terminalden Görevleri, Projeleri ve Belgeleri yönetin.

Quire CLI, Quire MCP sunucusuyla aynı mıdır?

Hayır. Quire CLI, komut yazan insanlar içindir. Quire MCP sunucusu, Quire'ı araç olarak çağıran yapay zeka ajanları içindir. Aynı veri, farklı hedef kitle.

Quire CLI'ı kullanmak için geliştirici olmam gerekiyor mu?

Hayır. Bir terminal açıp iki komut çalıştırabiliyorsanız kullanabilirsiniz.

Quire CLI ile ne yapabilirim?

Görevleri listeleyin ve arayın, toplu oluşturun, tamamlayın, Alt görevleri düzenleyin, Projeleri ve Üyeleri yönetin, yorum ekleyin, Belge oluşturun. Her Quire nesnesine ulaşılabilir.

MCP sunucusunu ne zaman kullanmalıyım?

İşin akıl yürütme gerektirdiği durumlarda. Triyaj, özetleme, yapılandırılmamış notları Görevlere dönüştürme. Quire CLI, deterministik yarı içindir.

Quire CLI cron işlerinde çalışır mı?

Evet. --json çıktısını kullanın, cron'dan Ajanda kurun, sonuçları istediğiniz yere gönderin.

Ücretsiz bir katman var mı?

Evet. Quire'ın Free planı, ücretli planlarla aynı CLI erişimini kapsar.

Quire çalışma alanınızı terminalden yönetmeye hazır mısınız?

Quire CLI'ı kurun: npm, Homebrew veya GitHub Releases. Free Quire hesabı, tam erişim, kredi kartı gerekmez.