Introduksjon

SlopCode er en åpen kildekode AI kodeagent. Den er tilgjengelig som et terminalbasert grensesnitt, skrivebordsapp eller IDE-utvidelse.

SlopCode TUI med slopcode-temaet

La oss komme i gang.

Forutsetninger

For å bruke SlopCode i terminalen din trenger du:

En moderne terminalemulator som:
- WezTerm, på tvers av plattformer
- Alacritty, på tvers av plattformer
- Ghostty, Linux og macOS
- Kitty, Linux og macOS
API-nøkler for LLM-leverandørene du vil bruke.

Installasjon

Den enkleste måten å installere SlopCode på er gjennom installasjonsskriptet.

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

Du kan også installere den med følgende kommandoer:

Bruke 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
Bruke Homebrew på macOS og Linux
Terminal window
```
brew install slopcode
```
Vi anbefaler å bruke SlopCode-tappen for de mest oppdaterte utgivelsene. Den offisielle brew install slopcode-formelen vedlikeholdes av Homebrew-teamet og oppdateres sjeldnere.

Bruke Paru på Arch Linux

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

Windows

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

Bruke Docker

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

Støtte for installasjon av SlopCode på Windows med Bun er under arbeid.

Du kan også hente binæren fra Releases.

Konfigurasjon

Med SlopCode kan du bruke hvilken som helst LLM-leverandør ved å konfigurere deres API-nøkler.

Hvis du er ukjent med LLM-leverandører, anbefaler vi å bruke SlopCode Zen. Det er en kuratert liste over modeller som har blitt testet og verifisert av SlopCode-teamet.

Kjør kommandoen /connect i TUI, velg SlopCode og gå til slopcode.dev/auth.
```
/connect
```
Logg på, legg til faktureringsdetaljene dine og kopier API-nøkkelen.
Lim inn API-nøkkelen.
```
┌ API key
│
│
└ enter
```

Alternativt kan du velge en av de andre leverandørene. Finn ut mer.

Initialisering

Nå som du har konfigurert en leverandør, kan du navigere til et prosjekt som du vil jobbe med.

cd /path/to/project

Og kjør SlopCode.

slopcode

Deretter initialiserer du SlopCode for prosjektet ved å kjøre følgende kommando.

/init

Dette vil få SlopCode til å analysere prosjektet ditt og opprette en AGENTS.md-fil i prosjektroten.

Dette hjelper SlopCode med å forstå prosjektstrukturen og kodingsmønstrene brukt.

Bruk

Du er nå klar til å bruke SlopCode for å jobbe med prosjektet ditt. Spør det gjerne noe!

Hvis du er ukjent med AI-kodeagenter, her er noen eksempler som kan hjelpe.

Still spørsmål

Du kan be SlopCode forklare kodebasen for deg.

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

Dette er nyttig hvis det er en del av kodebasen du ikke har jobbet med.

Legg til funksjonalitet

Du kan be SlopCode legge til nye funksjoner i prosjektet ditt. Selv om vi først anbefaler å be den om å lage en plan.

Lag en plan

SlopCode har en Plan-modus som deaktiverer muligheten til å gjøre endringer og foreslår i stedet hvordan den vil implementere funksjonen.

Bytt til den ved å bruke Tab-tasten. Du vil se en indikator for dette i nedre høyre hjørne.
```
<TAB>
```
La oss nå beskrive hva vi vil at den skal gjøre.
```
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.
```
Du bør gi SlopCode nok detaljer til å forstå hva du ønsker. Det hjelper å snakke med det som om du snakker med en juniorutvikler på laget ditt.

Gi SlopCode mye kontekst og eksempler for å hjelpe den å forstå hva du ønsker.
Iterer på planen

Når du får en plan, kan du gi den tilbakemelding eller legge til flere detaljer.
```
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.
```
Dra og slipp bilder i terminalen for å legge dem til ledeteksten.

SlopCode kan skanne alle bilder du gir den og legge dem til i ledeteksten. Du kan gjør dette ved å dra og slippe et bilde inn i terminalen.
Bygg funksjonen

Når du føler deg komfortabel med planen, bytt tilbake til Byggemodus ved å trykke på Tab-tasten igjen.
```
<TAB>
```
Og be den om å gjøre endringene.
```
Sounds good! Go ahead and make the changes.
```

Gjør endringer

For mer enkle endringer kan du be SlopCode om å bygge det direkte uten å måtte gjennomgå planen først.

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

Sørg for å gi nok detaljer, slik at SlopCode gjør de rette endringene.

Angre endringer

La oss si at du ber SlopCode om å gjøre noen endringer.

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

Men du skjønner at det ikke er det du ønsket. Du kan angre endringene ved å bruke kommandoen /undo.

/undo

SlopCode vil nå tilbakestille endringene du har gjort og vise den opprinnelige meldingen igjen.

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

Herfra kan du justere ledeteksten og be SlopCode om å prøve igjen.

Eller du kan gjøre om endringene ved å bruke /redo-kommandoen.

/redo

Deling

Samtalene du har med SlopCode kan deles med din team.

/share

Dette vil opprette en kobling til den gjeldende samtalen og kopiere den til utklippstavlen.

Her er en eksempelsamtale med SlopCode.

Tilpasning

Og det er det! Du er nå en proff på å bruke SlopCode.

For å tilpasse det anbefaler vi å velge et tema, tilpasse tastebindingene, konfigurere kodeformattere, opprette egendefinerte kommandoer eller leke med SlopCode-konfigurasjonen.