İndirme ve Kurulum

Tarayıcınızda Mample kullanmak için öncelikle tarayıcınıza uygun eklentiyi (Chrome, Mozilla, Opera, Edge) ve mobil uygulamamızı Google Play Store'dan indirmeniz gerekiyor.

Eşleşme ve Bağlantı Yönetimi

Mobil cihazınızdaki Mample uygulaması ile tarayıcı eklentisindeki QR Kodu okutarak veya Secret Key'inizi (gizli anahtarınızı) eklentideki ilgili yere girerek cihazınızı anında bağlayabilirsiniz. Bağlantıyı mobil uygulamanızdaki "Bağlı Cihazlar" kısmında görebilirsiniz.

Güvenliğiniz için tüm eklenti bağlantıları 23 saat sonra otomatik olarak kesilir. İsterseniz telefonunuzdaki "Bağlantıyı Kes" ikonuna (kırık zincir) tıklayarak veya eklentinizden bağlantıyı anında manuel olarak da koparabilirsiniz.

Tuş Seçimi Yaparak Bildirim Alma

Web sitesinde /mample yazarak veya eklentiden Tuş Seç diyerek, takip etmek istediğiniz butonu öğretebilirsiniz. Bunu yaptığınızda ekranda bir tuş seçme arayüzü belirecektir. Seçeceğiniz bu tuş; işlem başladığında ekranda beliren ve işlem bittiğinde kaybolan, animasyonsuz ve sabit bir öğe olmalıdır. Örneğin: 'İşlemi Durdur' veya 'Stop generating' butonu gibi. Öğrettikten sonra ilgili işlemi yapıp /mample yazdığınızda, Mample arka planda butonu izler ve işlem bitip buton kaybolduğunda size bildirim gönderir. Seçtiğiniz tuş kaydedilir ve bir daha seçmenize gerek kalmaz.

Tuşunuzu öğrettikten sonra, bildirim almanın iki yolu vardır:

1. Komut Kullanarak: Komutunuzun (prompt) sonuna sadece /mample yazın. Mample o işlemi takip edecek ve bittiğinde tek seferlik bildirim gönderecektir.

2. Eklentiyi Kullanarak: Yazı alanı bulunmayan (prompt girilemeyen) sitelerde kullanmak veya işlemleri tamamen otomatikleştirmek için eklentideki Seçili Tuştan Bildirim Al seçeneğini işaretleyebilirsiniz. Böylece öğrettiğiniz buton her kaybolduğunda arka planda otomatik bildirim alırsınız.

Eğittiğiniz siteleri görmek ve yönetmek için eklentideki ☰ menüsünü kullanabilirsiniz.

ÖNEMLİ NOT: İşlem beklerken sekmenin ve ekranın açık kalmasını şiddetle tavsiye ederiz. Çoğu modern web sitesi, sekme arka plana atıldığında kaynak tasarrufu sağlamak için HTML güncellemelerini durdurur. Site arka plandayken arayüzünü güncellemediği için, Mample işlemi bitirdiğinizi siz sekmeye geri dönene kadar algılayamayabilir.

Dosya İndirmelerinden Bildirim Alma

Eklentinizdeki İndirmelerden Bildirim Al seçeneği ile tarayıcınızda belirlediğiniz MB limitinden büyük dosyaların indirilme işlemi tamamlandığında bildirim alabilirsiniz.

CLI Kurulumu ve Bağlantı

Terminalden bildirim alabilmek için öncelikle mobil uygulamamızı Google Play Store'dan indirmeniz gerekir. Ardından, bilgisayarınıza Mample CLI aracını global olarak kurmalısınız. Bunun için bilgisayarınızda bir terminal, PowerShell veya Komut İstemi (CMD) açarak aşağıdaki komutu çalıştırın:

Kurulum tamamlandıktan sonra, telefonunuzdaki Mample uygulamasını açın. Ana ekrandaki Terminal Aracı bölümünde yer alan Secret Key (Gizli Anahtar) bilginizi kullanarak terminale aşağıdaki bağlantı komutunu girin:

Bildirim Gönderme

Mample'ı bir komut bittikten sonra tetiklemek için && mample (başarılıysa) veya || mample (hatalıysa) yazarak komutları arka arkaya zincirleyebilirsiniz. Test amaçlı özel mesaj göndermek isterseniz mample "<mesajınız>" formatını kullanabilirsiniz.

Bağlantıyı Koparma

Terminal ile telefonunuz arasındaki bağlantıyı sonlandırmak için, mobil uygulamanızın ana ekranındaki Bağlı Cihazlar bölümünü kullanabilirsiniz. Bu işlemi doğrudan terminal üzerinden yapmak isterseniz şu komutu girebilirsiniz:

Mample'ı Kaldırma (Silme)

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

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:

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

Yapay zeka asistanlarından bildirim alabilmek için öncelikle mobil uygulamamızı Google Play Store'dan indirmeniz gerekir. Ardından, Mample'ı terminal komutu çalıştırabilen AI asistanlarıyla (VS Code, Antigravity, GitHub Copilot, Cursor, Cline, Roo Code vb.) entegre olarak kullanabilirsiniz. Bunun için "CLI Kurulumu ve Bağlantı" adımında anlatıldığı gibi Mample CLI'ı bilgisayarınıza kurup eşleştirmeniz yeterlidir.

Talimat Verme

Asistanınıza yapmasını istediğiniz görevi verirken, promptunuzun sonuna işlemi bitirdiğinde terminalden mample komutunu çalıştırarak beni uyar gibi basit bir talimat ekleyebilirsiniz. Tam olarak bu cümleyi kurmak zorunda değilsiniz; asistanın işlemi bitirdiğinde terminalden komutu çağırmasını istemeniz yeterlidir. Asistan işlemi bitirdiğinde otonom bir şekilde `mample` komutunu çalıştırarak size bildirim gelmesini sağlayacaktır.

İlk Kullanımda Dikkat Edilmesi Gerekenler

Yapay zeka asistanınızdan ilk defa Mample'yi uyarmasını istediğinizde, komutun çalıştırılması için bir güvenlik/izin uyarısı çıkacaktır.

Eğer kırmızıyla işaretlenmiş olan "2. Yes, and always allow 'mample'" seçeneğini seçerseniz, bu uyarı bir daha karşınıza çıkmayacaktır. Yapay zeka asistanınız bu izni hatırlayacak ve Mample'yi uyar dediğinizde size hiçbir şey sormadan direkt bildirim yollayacaktır.

İzin İsteklerini Tamamen Kapatma

Yapay zeka asistanları bazen global `mample` komutunu kullanmak yerine komutu node üzerinden (örneğin `node bin/index.js`) çalıştırmayı deneyebilir. Bu durumda, daha önce 'Her zaman izin ver' demiş olsanız bile IDE farklı bir komut gördüğü için tekrar izin isteyecektir. Bu sorunu çözmek ve bildirimleri tamamen sessiz hale getirmek için asistanınızın kural dosyasına (örn. `.cursorrules` veya AI Rules kısmı) şu kuralı ekleyin: "Bir görevi tamamladığında, bana bildirim göndermek için HER ZAMAN terminalde global 'mample' komutunu otonom olarak çalıştır. IDE izin istemlerini tetiklememek için node veya script yollarını KULLANMA." Alternatif olarak, asistanınızın okuması için şu iki dosyayı doğrudan projenize koyabilirsiniz: CLAUDE.md ve setup.md

Web Mimarisi (DOM İzleme)

Tarayıcı eklentisi ağ trafiğinizi veya kişisel verilerinizi asla okumaz. Sadece seçtiğiniz spesifik HTML elementinin görünürlüğünü takip eden bir DOM İzleme (DOM Observer) mekanizması kullanır. Element DOM'dan silindiğinde tetikleyiciyi çalıştırır.

Terminal Mimarisi (CLI)

Terminal aracı, arka planda sürekli çalışan bir servis değildir. Sadece `mample` komutunu açıkça çağırdığınızda çalışır ve bildirimi iletmek için Firebase sunucularımıza tek seferlik bir HTTPS isteği gönderir.

Bağlantı ve Güvenlik: CLI aracı girilen son Secret Key'i tek geçerli anahtar kabul eder. Eğer aynı cihaza ikinci bir `mample auth ` komutu girilirse eski anahtar silinir ve tüm yeni komutlar sadece son bağlanan cihaza gider. Ancak, aynı Secret Key'i dilediğiniz sayıda farklı bilgisayarda aynı anda kullanabilirsiniz (örneğin ev ve iş bilgisayarınızda). Tüm bu bilgisayarlardaki terminal işlemleri aynı telefona sorunsuz şekilde bildirim göndermeye devam eder. Ayrıca, mobil uygulamadan 'Secret Key Yenile' dendiği anda, güvenlik gereği eski anahtar Firebase üzerinden anında silinir. Bu durumda bilgisayarlarınızdaki mevcut bağlantınız kopar ve komutlarınızın iletilebilmesi için terminallerinizden yeni anahtarla tekrar `auth` yapmanız gerekir.

IDE ve Yapay Zeka Asistanları

Mample'ın IDE'ler için özel bir eklentisi yoktur. Bunun yerine, yapay zeka asistanının terminal komutu çalıştırabilme yeteneğini kullanır. Yapay zeka görevini bitirdiğinde otonom olarak global `mample` CLI komutunu tetikler. Bu sayede terminal kullanabilen tüm agent'larla uyumludur.

Bulut ve İletim (Firebase FCM)

Anlık bildirimleri iletmek için Firebase Cloud Messaging (FCM) kullanıyoruz. Bildirim içerikleri hiçbir bulut veritabanında depolanmaz; Firebase sadece mesajı doğrudan cihazınıza iletmek için bir köprü görevi görür.

Ödeme ve Hesaplar (RevenueCat)

Mample'da kullanıcı hesap sistemi yoktur. Abonelikler App Store ve Google Play üzerinden güvenle işlenir. Kredi kartı bilgilerinizi asla saklamadan, cihazlar arası abonelik aktarımını sağlamak için tamamen rastgele oluşturulan anonim bir 'Transfer Kodu' ve RevenueCat altyapısı kullanılır.