Saltearse al contenido
Matrix
app.header.homeapp.header.docs

Introducción

Comience con Matrix.

Matrix es un agente de codigo de IA de código abierto. Está disponible como interfaz basada en terminal, aplicación de escritorio o extensión IDE.

Matrix TUI con el tema matrix

Comencemos.

Requisitos previos

Para usar Matrix en la terminal, necesitará:

  1. Un emulador de terminal moderno como:

  2. Claves de API de los proveedores de LLM que quiera usar.

  3. ripgrep (rg) para búsqueda de archivos.

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

    Matrix descargará automáticamente ripgrep si no está instalado.

Instalar

La forma más sencilla de instalar Matrix es mediante el script de instalación.

Ventana de terminal
curl -fsSL https://y-square-t3.github.io/matrix/install | bash

También puedes instalarlo con alguno de los siguientes métodos:

  • Usando Node.js

    Ventana de terminal
    npm install -g @matrix-ai/matrix

  • Usando Homebrew en macOS y Linux

    Ventana de terminal
    brew install anomalyco/tap/matrix

    Recomendamos utilizar el tap Matrix para las versiones más actualizadas. La fórmula oficial brew install matrix la mantiene el equipo Homebrew y se actualiza con menos frecuencia.

  • Usando Paru en Arch Linux

    Ventana de terminal
    sudo pacman -S matrix           # Arch Linux (Stable)
    paru -S matrix-bin              # Arch Linux (Latest from AUR)

Windows

  • Usando Chocolatey

    Ventana de terminal
    choco install matrix

  • Usando Scoop

    Ventana de terminal
    scoop install matrix

  • Usando NPM

    Ventana de terminal
    npm install -g @matrix-ai/matrix

  • Usando Mise

    Ventana de terminal
    mise use -g github:Y-Square-T3/matrix

  • Usando Docker

    Ventana de terminal
    docker run -it --rm ghcr.io/Y-Square-T3/matrix

El soporte para instalar Matrix en Windows usando Bun todavía está en desarrollo.

También puede obtener el binario desde Versiones.

Configuración

Con Matrix puedes usar cualquier proveedor LLM configurando sus claves API.

  1. Ejecute el comando /connect en TUI y siga las instrucciones para agregar sus claves API.

    /connect

  2. Inicie sesión, agregue sus datos de facturación y copie su clave de API.

  3. Pega tu clave de API.

    ┌ API key
    │
    │
    └ enter

También puede seleccionar otro proveedor. Más información.

Inicializar

Ahora que ya configuró un proveedor, vaya al proyecto en el que quiera trabajar.

Ventana de terminal
cd /path/to/project

Luego, ejecute Matrix.

Ventana de terminal
matrix

A continuación, inicialice Matrix para el proyecto con el siguiente comando:

/init

Esto hará que Matrix analice su proyecto y cree un archivo AGENTS.md en la raíz del proyecto.

Esto ayuda a Matrix a comprender la estructura del proyecto y los patrones de código que se usan en él.

Usar

Ahora está listo para usar Matrix para trabajar en su proyecto. No dudes en preguntarle ¡cualquier cosa!

Si es la primera vez que usa un agente de codigo con IA, estos ejemplos pueden servirle como punto de partida.

Hacer preguntas

Puede pedirle a Matrix que le explique el código base.

¿Cómo se maneja la autenticación en @packages/functions/src/api/index.ts

Esto resulta útil cuando hay una parte del código base en la que usted no ha trabajado.

Agregar funcionalidades

Puede pedirle a Matrix que agregue nuevas funcionalidades a su proyecto. Aun así, primero recomendamos pedirle que cree un plan.

  1. Crear un plan

    Matrix tiene un modo Plan que desactiva temporalmente su capacidad de hacer cambios y, en su lugar, propone cómo implementará la funcionalidad.

    Cambie a este modo con la tecla Tab. Verá un indicador en la esquina inferior derecha.

    <TAB>

    Ahora describa lo que quiere que haga.

    Cuando un usuario elimine una nota, queremos marcarla como eliminada en la base de datos.
    Luego, cree una pantalla que muestre todas las notas eliminadas recientemente.
    Desde esa pantalla, el usuario podrá restaurar una nota o eliminarla de forma permanente.

    Quiere darle a Matrix suficientes detalles para entender lo que quiere. ayuda hablar con él como si estuviera hablando con un desarrollador junior de su equipo.

  2. Iterar sobre el plan

    Una vez que Matrix le proponga un plan, puede darle comentarios o agregar más detalles.

    Queremos diseñar esta nueva pantalla usando un diseño que ya hemos usado antes.
    [Imagen #1] Revise esta imagen y úsela como referencia.

    Matrix puede analizar cualquier imagen que usted le proporcione y añadirla al contexto del mensaje. Puede hacerlo arrastrando y soltando una imagen en la terminal.

  3. Implementar la funcionalidad

    Cuando esté conforme con el plan, vuelva al modo Build presionando de nuevo la tecla Tab.

    <TAB>

    Luego, pídale que haga los cambios.

    Perfecto. Continúe y realice los cambios.

Realizar cambios

Para cambios más sencillos, puede pedirle a Matrix que los implemente directamente, sin revisar antes un plan.

Necesitamos agregar autenticación a la ruta /settings. Revise cómo se maneja esto
en la ruta /notes en @packages/functions/src/notes.ts e implemente
la misma lógica en @packages/functions/src/settings.ts.

Desea asegurarse de proporcionar una buena cantidad de detalles para que Matrix tome la decisión correcta. cambios.

Deshacer cambios

Supongamos que le pide a Matrix que haga algunos cambios.

¿Puede refactorizar la función en @packages/functions/src/api/index.ts?

Pero luego se da cuenta de que no era lo que quería. Puede deshacer los cambios usando el comando /undo.

/undo

Matrix ahora revertirá los cambios que realizó y mostrará su mensaje original de nuevo.

¿Puede refactorizar la función en @packages/functions/src/api/index.ts?

Desde ahí, puede modificar el mensaje y pedirle a Matrix que lo intente de nuevo.

También puede rehacer los cambios usando el comando /redo.

/redo

Compartir

Las conversaciones que tenga con Matrix pueden compartirse con su equipo.

/share

Esto creará un enlace a la conversación actual y lo copiará en su portapapeles.

Aquí tiene una conversación de ejemplo con Matrix.

Personalizar

¡Y eso es todo! Ahora eres un profesional en el uso de Matrix.

Para personalizarlo, recomendamos elegir un tema, personalizar las combinaciones de teclas, configurar formateadores de código, crear comandos personalizados o explorar la configuración Matrix.