Introducción

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

SlopCode TUI con el tema slopcode

Empecemos.

Requisitos previos

Para usar SlopCode en su terminal, necesitará:

Un emulador de terminal moderno como:
- WezTerm, multiplataforma
- Alacritty, multiplataforma
- Ghostty, Linux y macOS
- Kitty, Linux y macOS
Claves API para los LLM proveedores que desea utilizar.

Instalar

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

curl -fsSL https://slopcode.dev/install | bash

También puedes instalarlo con los siguientes comandos:

Usando Node.js
- npm
- Bun
- pnpm
- Yarn
Terminal window
npm install -g slopcode
Terminal window
bun install -g slopcode
Terminal window
pnpm install -g slopcode
Terminal window
yarn global add slopcode
Usando Homebrew en macOS y Linux
Terminal window
```
brew install slopcode
```
Recomendamos utilizar el tap SlopCode para las versiones más actualizadas. La fórmula oficial brew install slopcode la mantiene el equipo Homebrew y se actualiza con menos frecuencia.

Usando Paru en Arch Linux

sudo pacman -S slopcode           # Arch Linux (Stable)
paru -S slopcode-bin              # Arch Linux (Latest from AUR)

Windows

Usando Chocolatey
Terminal window
```
choco install slopcode
```
Usando Scoop
Terminal window
```
scoop install slopcode
```
Usando NPM
Terminal window
```
npm install -g slopcode
```
Usando Mise
Terminal window
```
mise use -g github:grappeggia/slopcode
```

Usando Docker

docker run -it --rm ghcr.io/grappeggia/slopcode

Actualmente se encuentra en progreso el soporte para instalar SlopCode en Windows usando Bun.

También puede obtener el binario de Versiones.

Configuración

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

Si es nuevo en el uso de proveedores LLM, le recomendamos usar SlopCode Zen. Es una lista seleccionada de modelos que han sido probados y verificados por el equipo de SlopCode.

Ejecute el comando /connect en TUI, seleccione slopcode y diríjase a slopcode.dev/auth.
```
/connect
```
Inicie sesión, agregue sus datos de facturación y copie su clave API.
Pega tu clave API.
```
┌ API key
│
│
└ enter
```

Alternativamente, puede seleccionar uno de los otros proveedores. Más información.

Inicializar

Ahora que ha configurado un proveedor, puede navegar a un proyecto que quieres trabajar.

cd /path/to/project

Y ejecute SlopCode.

slopcode

A continuación, inicialice SlopCode para el proyecto ejecutando el siguiente comando.

/init

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

Esto ayuda a SlopCode a comprender la estructura del proyecto y los patrones de codificación. usado.

Usar

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

Si es nuevo en el uso de un agente de codificación de IA, aquí hay algunos ejemplos que podrían ayuda.

Hacer preguntas

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

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

Esto es útil si hay una parte del código base en la que no trabajaste.

Agregar funciones

Puede pedirle a SlopCode que agregue nuevas funciones a su proyecto. Aunque primero recomendamos pedirle que cree un plan.

Crea un plan

SlopCode tiene un Modo Plan que desactiva su capacidad para realizar cambios y en su lugar, sugiera cómo implementará la función.

Cambie a él usando la tecla Tab. Verás un indicador para esto en la esquina inferior derecha.
```
<TAB>
```
Ahora describamos lo que queremos que haga.
```
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.
```
Quiere darle a SlopCode suficientes detalles para entender lo que quiere. ayuda hablar con él como si estuviera hablando con un desarrollador junior de su equipo.

Dale a SlopCode mucho contexto y ejemplos para ayudarlo a comprender lo que desear.
Repetir el plan

Una vez que le proporcione un plan, puede enviarle comentarios o agregar más detalles.
```
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.
```
Arrastre y suelte imágenes en la terminal para agregarlas al mensaje.

SlopCode puede escanear cualquier imagen que le proporcione y agregarla al mensaje. Puede Haga esto arrastrando y soltando una imagen en la terminal.
Crea la función

Una vez que se sienta cómodo con el plan, vuelva al Modo Build presionando la tecla Tab nuevamente.
```
<TAB>
```
Y pidiéndole que haga los cambios.
```
Sounds good! Go ahead and make the changes.
```

Realizar cambios

Para cambios más sencillos, puede pedirle a SlopCode que lo construya directamente. sin tener que revisar el plan primero.

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

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

Deshacer cambios

Digamos que le pides a SlopCode que haga algunos cambios.

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

Pero te das cuenta de que no es lo que querías. Puedes deshacer los cambios usando el comando /undo.

/undo

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

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

Desde aquí puedes modificar el mensaje y pedirle a SlopCode que vuelva a intentarlo.

O puedes rehacer los cambios usando el comando /redo.

/redo

Las conversaciones que tengas con SlopCode pueden ser compartidas con tu equipo.

/share

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

Aquí hay una conversación de ejemplo con SlopCode.

Personalizar

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

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