Mobil ve CLI Rehberi

CLI Kurulumu ve Bağlantı

Önce Mample Android uygulaması gerekir; erişim durumu için indirme bölümüne bak. CLI aracını bilgisayarına kurmak için terminalinde aşağıdaki komutu çalıştır:

npm install -g mample

Kurulum tamamlandıktan sonra telefonunuzdaki Mample uygulamasını açın ve aşağıdaki iki bağlantı yönteminden birini seçin:

QR ile bağlanın

Terminalde aşağıdaki komutu çalıştırın, ardından gösterilen QR kodunu Mample uygulamasının QR okuyucusuyla okutun. Uygulamadaki Secret Key terminale güvenli biçimde aktarılır; anahtarı elle yazmanıza gerek kalmaz.

mample auth qr

Secret Key ile bağlanın

Ana ekrandaki Terminal Aracı bölümünden Secret Key’inizi (Gizli Anahtar) alın ve aşağıdaki komutta kendi anahtarınızı kullanın:

mample auth "your-secret-key"

Bildirim gönder

Telefonunu bağladıktan sonra doğrudan mesaj gönderebilir veya Mample’ı bir komutun sonuna ekleyebilirsin.

Mesajını çift tırnak içine yaz. Bu komut bildirimi hemen göndermek içindir.

mample "Bitti"

Telefonuna yazdığın mesaj gelir.

Mample’ı komutunun sonuna ekle

Gri kısmı kendi komutunla değiştir, sonundaki yeşil kısmı koru. Komutun sona erince, hata verse bile, Mample Bitti mesajını gönderir.

Windows — PowerShell

Komut satırının başında PS yazıyorsa bu örneği kullan. PowerShell 5.1 ve 7 ile çalışır.

Start-Sleep -Seconds 5; mample "Bitti"

Windows — Command Prompt (Komut İstemi / cmd)

Command Prompt (cmd) kullanıyorsan bu örneği seç; komut satırının başında PS yazmaz.

timeout /t 5 /nobreak >nul & mample "Bitti"

macOS / Linux — Terminal (Bash veya Zsh)

sleep 5; mample "Bitti"

Bildirim gelmiyorsa

Telefon ve bilgisayarın internet bağlantısını, Android ayarlarındaki Mample bildirim iznini ve uygulamadaki Bağlı Cihazlar kaydını kontrol et. Önce doğrudan test mesajı gönder, sonra uzun komutuna ekle. Telefonun pil tasarrufu ve arka plan kısıtlamaları teslimatı geciktirebilir.

Çok sık gönderimde CLI bekleme süresi bildirir. Bu süre dolmadan tekrar deneme. Aylık kota yoktur; kısa süreli sınırlar spam gönderimini önler.

Bağlantıyı Koparma

mample disconnect

mample disconnect bu terminalin sunucudaki bağlantısını kaldırır ve yerel kimlik bilgilerini temizler. Sunucu işlemi onaylayamazsa tekrar denemek için bilgiler korunur. Kurulu pakette komutun bulunduğunu mample help ile kontrol et. Uygulamadaki Bağlı Cihazlar bölümünden de bağlantıyı kaldırabilirsin. Secret Key’i yenilemek eski anahtarla yapılan tüm CLI isteklerini geçersiz kılar.

Mample'ı Kaldırma (Silme)

Mample CLI aracını bilgisayarınızdan tamamen silmek isterseniz terminalinizde aşağıdaki komutu çalıştırabilirsiniz:

npm uninstall -g mample

Terminal İçi Yardım

Kullanabileceğiniz tüm komutları ve detaylarını görmek için aşağıdaki yardım komutunu çalıştırabilirsiniz:

mample help

Kod Editörlerinde (IDE) Kurulum ve Bağlantı

Önce CLI kurulum adımlarıyla terminalini mobil uygulamaya bağla. Terminal komutları çalıştırabilen yapay zeka asistanın, görevi bitirdiğinde Mample komutunu çağırabilir.

Gerekli: Asistanının terminal erişimi olmalı ve Mample komutunu her seferinde yeni bir “Request Review” onayı beklemeden çalıştırabilmeli. Asistanından “Always allow / Her zaman izin ver” veya eşdeğer komut iznini ayarla. Kural dosyaları talimat verir; terminal izinleri ayrıca ayarlanır.

Talimat Verme

Görevin sonunda asistanına “Bana Mample kullanarak mobil bildirim gönder.” de.

Asistanına Kalıcı Bildirim Talimatı Ekle

setup.md dosyasını indir, tamamını kopyala ve kullandığın asistanın kural dosyasına veya özel talimat ayarına Mample kuralı olarak ekle. Örneğin Claude Code için CLAUDE.md, Codex veya Cursor için AGENTS.md, Antigravity için GEMINI.md, GitHub Copilot için .github/copilot-instructions.md kullanabilirsin. Mevcut kurallarını koru; terminal iznini ayrıca ayarla.

Terminal Mimarisi (CLI)

CLI, çağrıldığında çalışır; terminal görevlerini arka planda kendiliğinden izlemez. Verdiğin mesajı HTTPS üzerinden Firebase’e gönderir.

QR ve manuel Secret Key yöntemleri aynı terminal bağlantısını kurar. Aynı bilgisayarda başka bir mobil kurulumla eşleştirme, sonraki bildirimlerin hedefini değiştirir. Aynı telefonun anahtarıyla birden fazla bilgisayar bağlanabilir.

QR daveti kısa ömürlüdür; terminal bağlantısının otomatik sona erme süresi yoktur. Bağlantıyı uygulamadan veya mample disconnect ile kaldırabilirsin. Telefonda Secret Key’i yenilersen eski anahtar geçersiz olur ve terminallerini yeniden eşleştirmen gerekir.

IDE ve Yapay Zeka Asistanları

Mample, terminal komutu çalıştırabilen yapay zekâ asistanlarını kullanır. Asistana görev sonunda global mample komutunu çalıştırmasını söylersin. Mample görevin bittiğini kendiliğinden algılamaz; terminal erişimi ve komut izinleri asistana bağlıdır.

Bulut ve İletim (Firebase FCM)

Firebase Cloud Messaging, bildirimleri telefonuna iletir. Firebase'de anonim kullanıcı kimliği, FCM teslimat token'ı, CLI Secret Key'in hash'i, bağlı cihazlar ve bildirim tercihleri tutulur. Bildirim mesajları gönderim sırasında geçici bir kuyrukta saklanır ve işlendikten sonra silinir. Son 50 bildirimin geçmişi telefonda tutulur.

Ücretsiz kullanım

Mample'da premium paket, abonelik veya aylık bildirim kotası yok. Kısa süreli hız sınırları hizmeti spam gönderiminden korur. Telefon değiştirdiğinde yeni mobil kurulumu terminalinle yeniden eşleştirmen gerekir.