İçeriğe geç
Matrix
app.header.homeapp.header.docs

Giriş

Matrix kullanmaya başlayın.

Matrix açık kaynaklı bir AI kodlama ajanıdır. Terminal tabanlı bir arayüz, masaüstü uygulaması veya IDE uzantısı olarak mevcuttur.

matrix TUI with the matrix theme

Başlayalım.

Ön koşullar

Matrix’u terminalinizde kullanmak için ihtiyacınız olacak:

  1. Şu gibi modern bir terminal emülatörü:

  2. Kullanmak istediğiniz LLM sağlayıcılarının API anahtarları.

  3. Dosya arama için ripgrep (rg).

    • macOS: brew install ripgrep
    • Linux: sudo apt install ripgrep veya sudo pacman -S ripgrep
    • Windows: choco install ripgrep veya scoop install ripgrep

    Matrix, ripgrep yüklü değilse otomatik olarak indirecektir.

Kurulum

Matrix’u kurmanın en kolay yolu kurulum betiğidir.

Terminal window
curl -fsSL https://y-square-t3.github.io/matrix/install | bash

Ayrıca aşağıdaki komutlarla da yükleyebilirsiniz:

  • Node.js’yi kullanma

    Terminal window
    npm install -g @matrix-ai/matrix

  • Homebrew’u macOS ve Linux’ta kullanma

    Terminal window
    brew install anomalyco/tap/matrix

    En güncel sürümler için Matrix tap’ini kullanmanızı öneririz. Resmi brew install matrix formülü Homebrew ekibi tarafından korunur ve daha sık güncellenir.

  • Paru’yu Arch Linux’ta kullanma

    Terminal window
    sudo pacman -S matrix           # Arch Linux (Stable)
    paru -S matrix-bin              # Arch Linux (Latest from AUR)

Windows

  • Chocolatey Kullanımı

    Terminal window
    choco install matrix

  • Scoop Kullanımı

    Terminal window
    scoop install matrix

  • NPM kullanarak

    Terminal window
    npm install -g @matrix-ai/matrix

  • Mise Kullanımı

    Terminal window
    mise use -g github:Y-Square-T3/matrix

  • Docker’ı kullanma

    Terminal window
    docker run -it --rm ghcr.io/Y-Square-T3/matrix

Matrix’un Bun kullanılarak Windows’a yüklenmesine yönelik destek şu anda devam etmektedir.

İkili dosyayı Releases’dan da alabilirsiniz.

Yapılandırma

Matrix ile herhangi bir LLM sağlayıcısının API anahtarlarını yapılandırarak kullanabilirsiniz.

  1. TUI’de /connect komutunu çalıştırın ve API anahtarlarınızı eklemek için talimatları izleyin.

    /connect

  2. Oturum açın, fatura ayrıntılarınızı ekleyin ve API anahtarınızı kopyalayın.

  3. API anahtarınızı yapıştırın.

    ┌ API key
    │
    │
    └ enter

Alternatif olarak diğer sağlayıcılardan birini seçebilirsiniz. Daha fazla bilgi.

Başlatma

Artık bir sağlayıcı yapılandırdığınıza göre, üzerinde çalışmak istediğiniz bir projeye gidebilirsiniz.

Terminal window
cd /path/to/project

Ve Matrix’u çalıştırın.

Terminal window
matrix

Daha sonra aşağıdaki komutu çalıştırarak proje için Matrix’u başlatın.

/init

Bu, Matrix’un projenizi analiz etmesini ve bir AGENTS.md proje kökünde dosyası oluşturmasını sağlayacaktır.

Bu, Matrix’un proje yapısını ve kullanılan kodlama kalıplarını anlamasına yardımcı olur.

Kullanım

Artık projeniz üzerinde çalışmak için Matrix’u kullanmaya hazırsınız. Dilediğiniz soruyu sorabilirsiniz.

AI kodlama ajanını kullanmaya yeniyseniz aşağıdaki örnekler yardımcı olabilir.

Soru Sorma

Matrix’dan kod tabanını size açıklamasını isteyebilirsiniz.

How is authentication handled in @packages/functions/src/api/index.ts

Kod tabanının üzerinde çalışmadığınız bir kısmı varsa bu yararlı olur.

Özellik Ekleme

Matrix’dan projenize yeni özellikler eklemesini isteyebilirsiniz. Yine de öncelikle ondan bir plan oluşturmasını istemenizi öneririz.

  1. Bir plan oluşturun

    Matrix, değişiklik yapma özelliğini kapatan bir _Plan modu_\na sahiptir. Bu modda, özelliğin nasıl uygulanacağını önerir.

    Tab tuşunu kullanarak buna geçin. Bunun için sağ alt köşede bir gösterge göreceksiniz.

    <TAB>

    Şimdi ne yapmasını istediğimizi anlatalım.

    When a user deletes a note, we'd like to flag it as deleted in the database.
    Then create a screen that shows all the recently deleted notes.
    From this screen, the user can undelete a note or permanently delete it.

    Matrix’un isteğinizi anlaması için yeterli ayrıntı verin. Ekibinizdeki junior bir geliştiriciyle konuşur gibi yazmak genelde iyi sonuç verir.

  2. Planı yineleyin

    Size bir plan sunduğunda ona geri bildirimde bulunabilir veya daha fazla ayrıntı ekleyebilirsiniz.

    We'd like to design this new screen using a design I've used before.
    [Image #1] Take a look at this image and use it as a reference.

    Matrix verdiğiniz görselleri tarayıp prompt’a ekleyebilir. Bunu bir görseli terminale sürükleyip bırakarak yapabilirsiniz.

  3. Özelliği oluşturun

    Planı yeterli bulduğunuzda Tab tuşuna tekrar basarak _Build modu_\na dönün.

    <TAB>

    Ardından değişiklikleri yapmasını isteyin.

    Sounds good! Go ahead and make the changes.

Değişiklik Yapma

Daha basit değişikliklerde, önce planı incelemeden Matrix’dan doğrudan değişiklik yapmasını isteyebilirsiniz.

We need to add authentication to the /settings route. Take a look at how this is
handled in the /notes route in @packages/functions/src/notes.ts and implement
the same logic in @packages/functions/src/settings.ts

Matrix’un doğru değişiklikleri yapması için yeterli ayrıntı verdiğinizden emin olun.

Değişiklikleri Geri Alma

Diyelim ki Matrix’dan bazı değişiklikler yapmasını istediniz.

Can you refactor the function in @packages/functions/src/api/index.ts?

Ama istediğinin bu olmadığını anlıyorsun. /undo komutunu kullanarak değişiklikleri geri alabilirsiniz.

/undo

Matrix değişiklikleri geri alır ve orijinal mesajınızı tekrar gösterir.

Can you refactor the function in @packages/functions/src/api/index.ts?

Buradan komut isteminde ince ayar yapabilir ve Matrix’dan tekrar denemesini isteyebilirsiniz.

Veya /redo komutunu kullanarak değişiklikleri yeniden yapabilirsiniz.

/redo

Paylaşma

Matrix ile yaptığınız görüşmeleri ekibinizle paylaşabilirsiniz.

/share

Bu, mevcut konuşmaya bir bağlantı oluşturacak ve bunu panonuza kopyalayacaktır.

İşte Matrix ile bir örnek konuşma.

Özelleştirme

İşte bu kadar! Artık Matrix’u kullanma konusunda profesyonelsiniz.

Kendinize göre uyarlamak için tema seçebilir, tuş atamalarını özelleştirebilir, kod biçimlendirici ayarlayabilir, özel komutlar oluşturabilir veya Matrix config ile oynayabilirsiniz.