Ga naar inhoud

Entire CLI — Handleiding

Entire is een Git-natieve tool die AI-sessies (prompts, tool calls, transcripts) vastlegt naast je commits. Elke wijziging is herleidbaar naar de prompt die hem veroorzaakte. De CLI is open source (entireio/cli, MIT-licentie, Go).

Voor de governance-regels zie de werkafspraak Entire.

Hoe het werkt

Entire installeert Git-hooks in je repository die sessiedata vastleggen terwijl je werkt. Bij een git commit wordt een checkpoint aangemaakt — een snapshot van de volledige sessiecontext (prompts, tool-calls, gewijzigde bestanden, transcripts).

Checkpoint-data wordt opgeslagen op een aparte branch entire/checkpoints/v1, zodat je git-historie schoon blijft. Alleen een 12-tekens ID (bijv. a3b2c4d5e6f7) verschijnt als Entire-Checkpoint-trailer in je commit message.

Jouw branch                    entire/checkpoints/v1
     │                                  │
     ▼                                  │
[Base commit]                           │
     │                                  │
     │  ┌─── Agent werkt ───┐           │
     │  │  Stap 1           │           │
     │  │  Stap 2           │           │
     │  └───────────────────┘           │
     │                                  │
     ▼                                  ▼
[Commit] ─────────────────────► [Sessiemetadata]
                                 (transcript, prompts,
                                  bestanden)

Installatie

macOS (Homebrew)

brew tap entireio/tap
brew trust entireio/tap
brew install --cask entire

Linux

curl -fsSL https://entire.io/install.sh | bash

Voor ARM64:

curl -LO https://github.com/entireio/cli/releases/latest/download/entire-linux-arm64.tar.gz
tar -xzf entire-linux-arm64.tar.gz
sudo mv entire /usr/local/bin/

Windows (Scoop)

scoop bucket add entire https://github.com/entireio/scoop-bucket.git
scoop install entire/entire

Vanuit bron (Go 1.21+)

go install github.com/entireio/cli/cmd/entire@latest

Verifiëren

entire version

In onze omgeving

In de CEDA devcontainer is Entire al geconfigureerd. Je hoeft niets handmatigs te doen.

Automatische activatie

De claude-functie in de container voert automatisch het volgende uit bij het starten:

  1. entire enable -y --agent claude-code — installeert de hooks
  2. entire configure --checkpoint-remote github:cedanl/entire-checkpoints — wijst de checkpoint-repo aan
  3. Start Claude Code met --dangerously-skip-permissions

Dit gebeurt alleen in repos waar origin met cedanl/ begint.

Centrale checkpoint-repo

Alle checkpoints worden gesynchroniseerd naar cedanl/entire-checkpoints. Dit is een private repo waar de sessiedata van alle teamleden samenkomt. Bij een git push wordt de entire/checkpoints/v1 branch automatisch meegestuurd.

Configuratie

De configuratie staat in .entire/settings.json (gecommit in dev-dots):

{
  "enabled": true,
  "strategy_options": {
    "checkpoint_remote": {
      "provider": "github",
      "repo": "cedanl/entire-checkpoints"
    }
  }
}

Persoonlijke overrides kunnen in .entire/settings.local.json (niet gecommit).

Basisgebruik

Status controleren

entire status

Toont of Entire actief is, welke agent geconfigureerd is, en waar checkpoints naartoe gaan.

Checkpoints bekijken

entire checkpoint list             # alle checkpoints in deze repo
entire checkpoint explain          # leg uit waarom code veranderd is

Herleiden van regels

entire why <bestand>               # welke prompt heeft dit bestand veroorzaakt?
entire blame <bestand>             # welke regels kwamen uit een checkpoint?

entire blame en entire why zijn Labs-commando's. Bekijk welke beschikbaar zijn met entire labs.

Sessie hervatten

entire session resume <branch>     # hervat de laatste sessie op een branch

Herstelt de sessiemetadata en toont het commando om verder te gaan.

Samenvatting

entire dispatch                    # markdown samenvatting van recent AI-werk

Veiligheid

  • Redactie: Entire voert automatische redactie uit op cloud-credentials, tokens, sleutels en hoge-entropie strings voordat data wordt opgeslagen.
  • Opslag: Sessiedata staat in je git-repo op de entire/checkpoints/v1 branch. Als je repo publiek is, is deze data zichtbaar.
  • Lokale sessies: Tijdens een sessie maakt Entire tijdelijke shadow-branches aan met ongeredacteerde data. Deze worden niet gepusht.
  • Toegang: De cedanl/entire-checkpoints repo is private; alleen cedanl-leden hebben toegang.

Troubleshooting

Probleem Oplossing
Not a git repository Ga eerst naar een Git-repository
Entire is disabled Draai entire enable
shadow branch conflict Draai entire clean --force
SSH-fout bij session resume Voeg GitHub host keys toe: ssh-keyscan -t rsa github.com >> ~/.ssh/known_hosts
failed to unlock correct collection De OS-keyring is niet beschikbaar — gebruik ENTIRE_TOKEN_STORE=file entire login

Debug-modus

ENTIRE_LOG_LEVEL=debug entire status

Opschonen

entire clean --force              # sessiedata voor huidige commit
entire clean --all --force        # alle georkestreerde data
entire disable                    # verwijder hooks (code blijft onaangeroerd)

Bronnen