Introduksjon

Kom i gang med HanuBees.

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

HanuBees TUI med HanuBees-temaet

La oss komme i gang.

Forutsetninger

For å bruke HanuBees 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 HanuBees på er gjennom installasjonsskriptet.

curl -fsSL https://hanubees.com/install | bash

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

Bruke Node.js
- npm
- Bun
- pnpm
- Yarn
Terminal window
npm install -g hanubees
Terminal window
bun install -g hanubees
Terminal window
pnpm install -g hanubees
Terminal window
yarn global add hanubees
Bruke Homebrew på macOS og Linux
Terminal window
```
brew install varsansri/tap/hanubees
```
Vi anbefaler å bruke HanuBees-tappen for de mest oppdaterte utgivelsene. Den offisielle brew install hanubees-formelen vedlikeholdes av Homebrew-teamet og oppdateres sjeldnere.

Bruke Paru på Arch Linux

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

Windows

Bruke Chocolatey
Terminal window
```
choco install hanubees
```
Bruke Scoop
Terminal window
```
scoop install hanubees
```
Bruke npm
Terminal window
```
npm install -g hanubees
```

Bruke Mise

mise use -g github:varsansri/hanubees-coding-agent

Bruke Docker

docker run -it --rm ghcr.io/varsansri/hanubees-coding-agent

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

Du kan også hente binæren fra Releases.

Konfigurasjon

Med HanuBees 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 HanuBees Zen. Det er en kuratert liste over modeller som har blitt testet og verifisert av HanuBees-teamet.

Kjør kommandoen /connect i TUI, velg HanuBees og gå til hanubees.com/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 HanuBees.

HanuBees

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

/init

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

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

Bruk

Du er nå klar til å bruke HanuBees 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 HanuBees 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 HanuBees legge til nye funksjoner i prosjektet ditt. Selv om vi først anbefaler å be den om å lage en plan.

Lag en plan

HanuBees 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 HanuBees nok detaljer til å forstå hva du ønsker. Det hjelper å snakke med det som om du snakker med en juniorutvikler på laget ditt.

Gi HanuBees 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.

HanuBees 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 HanuBees 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 HanuBees gjør de rette endringene.

Angre endringer

La oss si at du ber HanuBees 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

HanuBees 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 HanuBees om å prøve igjen.

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

/redo

Deling

Samtalene du har med HanuBees 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 HanuBees.

Tilpasning

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

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