Skip to content

Latest commit

 

History

History
421 lines (313 loc) · 21.9 KB

File metadata and controls

421 lines (313 loc) · 21.9 KB
Hive

Hive

En åpen kildekode AI-agent orkestrator for parallell koding på tvers av prosjekter.

Kjør Claude Code, OpenCode og Codex økter parallelt. Ett vindu. Isolerte grener. Null fane-kaos.

English | العربية | বাংলা | Bosanski | Dansk | Deutsch | Ελληνικά | Español | Français | עברית | Italiano | 日本語 | 한국어 | Norsk | Polski | Português (BR) | Русский | ไทย | Türkçe | Українська | Tiếng Việt | 简体中文 | 繁體中文

Latest Release Downloads Build Status macOS Windows Linux Node.js Electron TypeScript License PRs Welcome


Innholdsfortegnelse

Installasjon

Hive støtter macOS, Windows og Linux.

macOS

Homebrew (Anbefalt)

brew install --cask hive-app

Direkte nedlasting

Last ned den nyeste .dmg fra GitHub Releases.

Windows

Last ned den nyeste .exe fra GitHub Releases.

Linux

Last ned den nyeste .AppImage eller .deb fra GitHub Releases.


Det er det! Åpne Hive og pek den mot et git-repo.

Hva er Hive?

Hvis du kjører flere AI-kodingsagenter på tvers av forskjellige prosjekter og grener, kjenner du smerten -- seks terminalfaner åpne, du husker ikke hvilken agent som jobber med hva, og du er bekymret for at to av dem redigerer de samme filene.

Hive er en AI-agent orkestrator. Se alle kjørende agenter i én sidepanel, klikk for å bytte mellom dem, og hver enkelt kjører på en isolert git worktree-gren slik at de ikke kan komme i konflikt. Koble sammen flere repositories slik at én enkelt agent-økt har kontekst på tvers av hele stacken din.

Funksjoner

🌳 Worktree-First Arbeidsflyt

Jobb på flere grener samtidig uten stashing eller switching. Opprett, arkivér og organiser worktrees med ett klikk. Hver worktree får et unikt navn basert på hunde- og katteraser for enkel identifikasjon.

🤖 Innebygde AI-kodingsøkter

Kjør AI-kodingsagenter direkte i Hive med OpenCode, Claude Code, og Codex støtte. Strøm svar i sanntid, se verktøykall utføres, og godkjenn tillatelser etter behov. Full undo/redo-støtte holder deg i kontroll.

📁 Smart Filutforsker

Se hva som er endret med et blikk med live git-statusindikatorer. Se diffs inline, bla gjennom filhistorikk og naviger i kodebasen uten å forlate appen. Integrert Monaco-editor gir en full VS Code-opplevelse.

🔧 Komplett Git-integrasjon

Commit, push, pull og administrer grener visuelt. Ingen terminal nødvendig for vanlige git-operasjoner. Se ventende endringer, stagede filer og commit-historikk alt på ett sted.

📦 Spaces for organisering

Grupper relaterte prosjekter og worktrees i logiske arbeidsområder. Fest favoritter for rask tilgang. Hold utviklingsmiljøet organisert etter hvert som du skalerer.

Kommandopalett

Naviger og handle raskt med hurtigtaster. Trykk Cmd+K for å få tilgang til enhver funksjon øyeblikkelig. Søk i økter, bytt worktrees eller kjør kommandoer uten å berøre musen.

🎨 Vakre temaer

Velg blant 10 nøye utformede temaer — 6 mørke og 4 lyse. Bytt øyeblikkelig for å matche preferansen din eller tiden på dagen. Følger systemtema automatisk om ønsket.

🔌 Worktree-tilkoblinger

Koble to worktrees sammen for å dele kontekst, sammenligne implementeringer eller samarbeide i sanntid. Perfekt for å gjennomgå endringer mellom grener, dele AI-økter på tvers av worktrees, eller opprettholde konsistens når du jobber med relaterte funksjoner. Se live oppdateringer når tilkoblede worktrees endres.

Hvorfor Hive?

Se hvordan Hive transformerer git-arbeidsflyten din:

Oppgave Tradisjonell arbeidsflyt Med Hive
Bytt gren git stashgit checkoutgit stash pop Klikk på worktree → Ferdig
Jobb på flere funksjoner Konstant stashing og kontekstbytte Åpne flere worktrees side ved side
Opprett worktree git worktree add ../project-feature origin/feature Klikk "Ny Worktree" → Velg gren
AI-kodingshjelp Terminal + separat AI-verktøy + kopier/lim Integrerte AI-økter med full kontekst
Se filendringer git statusgit diff file.ts Visuelt tre med inline diffs
Sammenlign grener Flere terminalfaner, kopier/lim mellom dem Koble worktrees for å dele kontekst
Finn en worktree cd ~/projects/... → husk mappenavn Alle worktrees i ett sidepanel
Rydd opp worktrees git worktree removerm -rf directory Klikk "Arkivér" → Håndterer alt

Hurtigstart

Kom i gang på under 2 minutter:

1️⃣ Legg til ditt første prosjekt

Åpne Hive → Klikk "Legg til Prosjekt" → Velg et vilkårlig git-repository på maskinen din

2️⃣ Opprett en Worktree

Velg prosjektet ditt → Klikk "Ny Worktree" → Velg en gren (eller opprett en ny)

3️⃣ Begynn å kode med AI

Åpne en worktree → Klikk "Ny Økt" → Begynn å kode med OpenCode, Claude, eller Codex

💡 Profftips: Trykk Cmd+K når som helst for å åpne kommandopaletten og navigere raskt!

📖 Les den fullstendige guiden | ⌨️ Hurtigtaster

🔌 Worktree-tilkoblinger - Den store game changeren

Hives Worktree-tilkoblinger funksjon lar deg koble to worktrees sammen, og skaper en bro mellom forskjellige grener eller funksjoner. Dette er utrolig kraftig for utviklingsarbeidsflyter som krever bevissthet på tvers av grener.

Hva er Worktree-tilkoblinger?

Koble to vilkårlige worktrees for å:

  • 🔄 Dele kontekst - Få tilgang til filer og endringer fra en annen gren øyeblikkelig
  • 🤝 Samarbeide - Jobb på relaterte funksjoner med live oppdateringer mellom worktrees
  • 📊 Sammenligne - Se forskjeller mellom implementeringer side ved side
  • 🎯 Referere - Hold hovedgrenen synlig mens du jobber med funksjoner
  • 🔗 Koble funksjoner - Koble frontend og backend grener for full-stack utvikling
  • 💬 Dele AI-økter - Fortsett AI-samtaler på tvers av forskjellige worktrees

Slik fungerer det

  1. Velg kilde-Worktree - Velg worktreen du jobber i
  2. Koble til mål - Klikk tilkoblingsikonet og velg en annen worktree
  3. Toveis-kobling - Begge worktrees blir bevisste på hverandre
  4. Sanntidsoppdateringer - Se endringer i tilkoblede worktrees når de skjer

Tilkoblingsfunksjoner

  • Live synkronisering - Filendringer i én worktree vises i tilkoblingspanelet
  • Raskt bytte - Hopp mellom tilkoblede worktrees med ett klikk
  • Diff-visning - Sammenlign filer mellom tilkoblede worktrees
  • Delt terminal - Kjør kommandoer som påvirker begge worktrees
  • AI-kontekstdeling - AI-økter kan referere til kode i tilkoblede worktrees
  • Statusindikatorer - Se build-status, tester og endringer i tilkoblede worktrees
  • Tilkoblingshistorikk - Spor hvilke worktrees som var tilkoblet og når
  • Smarte forslag - Hive foreslår relevante worktrees å koble til basert på arbeidsflyten din

Eksempler på bruk

Funksjonsutvikling: Koble feature-grenen din til main for å sikre kompatibilitet og se hvordan endringene dine integreres.

Feilrettinger: Koble bugfix-worktree til produksjonsgrenen for å verifisere at rettelsen fungerer i kontekst.

Kodegjennomgang: Koble reviewer og forfatter worktrees for å diskutere endringer med full kontekst på begge sider.

Full-Stack utvikling: Koble frontend og backend worktrees for å jobbe med API og UI samtidig med perfekt koordinasjon.

Refaktorering: Koble gamle og nye implementeringer for å sikre funksjonsparitet under store refaktoreringer.

Se det i aksjon

Hive demo — orkestrér AI-agenter på tvers av prosjekter
Flere skjermbilder

Hive — AI-kodingsøkt med git worktrees AI-drevne kodingsøkter med integrert git worktree-styring

Oppretting av ny worktree Opprett og administrer worktrees visuelt

Filtre med git-status Filutforsker med live git-statusindikatorer

Tema-utstilling Vakre temaer for enhver preferanse

Fellesskap & Støtte

Documentation Issues Discussions Contributing Security

Få hjelp

Ressurser

Veikart

🚀 Kommer snart

  • Plugin-system — Utvid Hive med tilpassede integrasjoner
  • Skysynkronisering — Synkroniser innstillinger, økter og tilkoblingsmaler på tvers av enheter
  • Teamfunksjoner — Del worktrees og samarbeid i sanntid
  • Git graf-visualisering — Visuell grenhistorikk og sammenslåinger
  • Ytelsesprofilering — Innebygde verktøy for optimalisering

🎯 Fremtidsvisjon

  • Fjernutvikling — SSH og container-basert utvikling
  • Treveis-tilkoblinger — Koble og slå sammen flere grener visuelt
  • CI/CD-integrasjon — GitHub Actions, GitLab CI, Jenkins overvåking
  • Tilkoblingsautomatisering — Auto-koble relaterte grener basert på mønstre
  • Kodegjennomgangsmodus — Spesiell tilkoblingstype optimalisert for gjennomganger
  • Tidssporing — Per-worktree og per-tilkobling aktivitetsanalyse

Vil du påvirke veikartet? Delta i diskusjonen eller bidra!


Utvikling

Forutsetninger

  • Node.js 20+
  • pnpm 9+
  • Git 2.20+ (worktree-støtte)

Oppsett

git clone https://github.com/anomalyco/hive.git
cd hive
pnpm install
pnpm dev

Ghostty Terminal (Valgfri)

Hive inkluderer en valgfri native terminal drevet av Ghosttys libghostty. Dette er bare nødvendig hvis du vil jobbe med den innebygde terminalfunksjonen.

Oppsett:

  1. Bygg libghostty fra Ghostty-kildekoden (byggeveiledning):

    cd ~/Documents/dev
    git clone https://github.com/ghostty-org/ghostty.git
    cd ghostty
    zig build -Doptimize=ReleaseFast

    Dette produserer macos/GhosttyKit.xcframework/macos-arm64_x86_64/libghostty.a.

  2. Hvis Ghostty-repoet ditt er på ~/Documents/dev/ghostty/, finner bygget det automatisk. Ellers, sett stien:

    export GHOSTTY_LIB_PATH="/path/to/libghostty.a"
  3. Gjenoppbygg den native addon:

    cd src/native && npx node-gyp rebuild

Hvis libghostty ikke er tilgjengelig, bygger og kjører Hive fremdeles -- Ghostty terminalfunksjonen vil bare være deaktivert.

Kommandoer

Kommando Beskrivelse
pnpm dev Start med hot reload
pnpm build Produksjonsbygg
pnpm lint ESLint-sjekk
pnpm lint:fix ESLint auto-fix
pnpm format Prettier-formatering
pnpm test Kjør alle tester
pnpm test:watch Watch-modus
pnpm test:e2e Playwright E2E-tester
pnpm build:mac Pakke for macOS

Arkitektur

Hive bruker Electrons tre-prosessmodell med streng sandboxing:

┌─────────────────────────────────────────────────────┐
│                    Main Process                      │
│               (Node.js + SQLite)                     │
│                                                      │
│  ┌──────────┐ ┌──────────┐ ┌───────────────────┐   │
│  │ Database  │ │   Git    │ │  Agent SDK Mgr    │   │
│  │ Service   │ │ Service  │ │  (AI Sessions)    │   │
│  └──────────┘ └──────────┘ └───────────────────┘   │
│                      │                               │
│              ┌───────┴───────┐                       │
│              │  IPC Handlers │                       │
│              └───────┬───────┘                       │
└──────────────────────┼──────────────────────────────┘
                       │ Typed IPC
┌──────────────────────┼──────────────────────────────┐
│              ┌───────┴───────┐                       │
│              │    Preload    │                       │
│              │   (Bridge)    │                       │
│              └───────┬───────┘                       │
└──────────────────────┼──────────────────────────────┘
                       │ window.* APIs
┌──────────────────────┼──────────────────────────────┐
│                 Renderer Process                     │
│              (React + Tailwind)                      │
│                                                      │
│  ┌──────────┐ ┌──────────┐ ┌───────────────────┐   │
│  │ Zustand   │ │ shadcn/  │ │    Components     │   │
│  │ Stores    │ │ ui       │ │  (14 domains)     │   │
│  └──────────┘ └──────────┘ └───────────────────┘   │
└─────────────────────────────────────────────────────┘

Prosjektstruktur

src/
├── main/                  # Electron hovedprosess (Node.js)
│   ├── db/                # SQLite database + skjema + migrasjoner
│   ├── ipc/               # IPC handler-moduler
│   └── services/          # Git, AI agents, logger, fil-tjenester
├── preload/               # Bro-lag (typede window.* API-er)
└── renderer/src/          # React SPA
    ├── components/        # UI organisert etter domene
    ├── hooks/             # Tilpassede React hooks
    ├── lib/               # Verktøy, temaer, hjelpere
    └── stores/            # Zustand state management

Tech Stack

Lag Teknologi
Rammeverk Electron 41
Frontend React 19
Språk TypeScript 5.7
Styling Tailwind CSS 4 + shadcn/ui
State Zustand 5
Database better-sqlite3 (WAL-modus)
AI OpenCode, Claude Code, Codex
Git simple-git
Bygg electron-vite

Dokumentasjon

Detaljert dokumentasjon finnes i docs/:

Bidra

Vi elsker bidrag! Hive er bygget av utviklere, for utviklere, og vi ønsker forbedringer av alle slag velkommen.

Måter å bidra

  • 🐛 Rapporter feil med klare reproduksjonssteg
  • 💡 Foreslå funksjoner som vil forbedre arbeidsflyten din
  • 📝 Forbedre dokumentasjon for å hjelpe andre i gang
  • 🎨 Send inn UI/UX-forbedringer for bedre brukervennlighet
  • 🔧 Fiks feil fra vår issue tracker
  • Optimaliser ytelse i kritiske stier
  • 🧪 Legg til tester for å forbedre dekning
  • 🌐 Oversett appen til ditt språk

Før du bidrar, les vennligst våre Retningslinjer for bidrag og Adferdskodeks.

Hurtig bidragsguide

  1. Fork repositoriet
  2. Opprett en feature-gren (git checkout -b feature/amazing-feature)
  3. Gjør endringene dine
  4. Kjør tester (pnpm test) og linting (pnpm lint)
  5. Commit med en beskrivende melding
  6. Push til din fork
  7. Åpne en Pull Request

Se CONTRIBUTING.md for detaljerte retningslinjer.

Lisens

MIT © 2024 morapelker

Hive er åpen kildekode programvare lisensiert under MIT-lisensen. Se LICENSE filen for fullstendige detaljer.