Haal Clavitor op je machine.

Download

Clavitor CLI

Single binary. Fetch credentials, generate TOTP, store new secrets. Zero dependencies.

Clavitor Proxy

HTTPS proxy that injects credentials into agent requests. WASM crypto, no CGO, zero dependencies.

Download SHA256SUMS · verify with sha256sum -c SHA256SUMS

Browserextensie

Vul je inloggegevens liever in de browser in? De Clavitor-extensie plaatst wachtwoorden, passkeys, kaarten en eenmalige codes in het veld dat ze daadwerkelijk wil hebben — terwijl je kluis op afstand blijft, zonder caching of ontsleuteling op je machine.

Nu beschikbaar voor Chrome. Firefox en Safari volgen binnenkort.

Stel een AI-agent in

Twee stappen. Minder dan een minuut van een verse CLI-installatie tot een werkende AI-agent-identiteit.

1. Maak de AI-agent aan in je kluis

Ga in de webinterface van je kluis naar Agents → New. Geef de agent een naam (bijvoorbeeld "Claude Code") en kies welke items hij mag openen. Clavitor geeft een enrollment blob en een enrollment key terug. De blob is verzegeld (hij bevat het kluisadres en de identiteit van de agent); de sleutel is het enige geheim dat hem opent. Behandel de sleutel als een wachtwoord: geef hem rechtstreeks aan de machine waarop de agent draait, en gooi hem daarna weg.

2. Initialiseer de CLI op de machine van de AI-agent

$ clavitor-cli init <enrollment-blob>
Enrollment key:

De CLI vraagt om de sleutel (die wordt nooit op de opdrachtregel meegegeven en niet weergegeven), ontsleutelt de blob lokaal en slaat het resultaat op als versleutelde lokale configuratie in ~/.config/clavitor/config (of $XDG_CONFIG_HOME/clavitor/config). Je hebt de blob of de sleutel daarna niet meer nodig. Het volgende deel laat zien hoe de agent de CLI vanaf hier gebruikt.

Stel de proxy in

Voor AI-agenten die al HTTP/HTTPS spreken — Claude Desktop, aangepaste scripts, alles wat requests of fetch gebruikt. De proxy zit tussen de AI-agent en de upstream API, en lost clavitor://Entry/field placeholders op de wire op, zodat de AI-agent nooit de daadwerkelijke inloggegevens bevat. Zie de proxy-architectuurpagina voor het dreigingsmodel en protocoldetails.

De walkthrough is conversatieel geschreven, zodat een mens of een AI-agent deze van begin tot eind kan lezen en uitvoeren op een echte machine. Kies hieronder je besturingssysteem — elke sectie is een op zichzelf staande procedure van zes stappen.

Voordat je begint: haal een enrollment blob en sleutel op uit de kluis

Je hebt een enrollment blob en de bijbehorende enrollment key uit je kluis nodig. Dit is het enige deel dat alleen een mens kan doen — de kluis vereist een tik op de hardware om een nieuwe agent te autoriseren.

Ga in de webinterface van de kluis naar Agents → New, geef de agent een naam (bijv. "Local Proxy"), kies welke items hij mag openen en tik op je beveiligingssleutel wanneer daarom wordt gevraagd. Clavitor geeft een enrollment blob en een enrollment key terug. Kopieer beide. In de stappen hieronder plak je elk één keer en vergeet je ze daarna.

Linux

De onderstaande walkthrough gebruikt bash en gaat ervan uit dat je op x86-64 zit; vervang arm64 door amd64 als je op aarch64 zit.

1. Download de proxy-binary en maak deze uitvoerbaar. Een enkele, zelfstandige binary, geen afhankelijkheden:

$ curl -LO https://clavitor.ai/downloads/clavitor-proxy-linux-amd64
$ chmod +x clavitor-proxy-linux-amd64

2. Het binaire bestand staat op schijf. Koppel het nu aan je kluis. De proxy leest de blob en de sleutel van stdin (nooit van de opdrachtregel, zodat ze niet in je shellgeschiedenis lekken). Plak elk uit "Voordat je begint" wanneer daarom wordt gevraagd (de sleutel wordt niet weergegeven) en bevestig daarna de kluishost die je te zien krijgt:

$ ./clavitor-proxy-linux-amd64 init
Paste enrollment blob, then press Enter:
<paste-the-blob-here>
Enrollment key:
<paste-the-key-here>

  This token enrolls the agent against vault:

      <vault-host>

  Your key authenticated the blob — NOT this host. If you did not get
  this blob from your own vault operator, answering yes hands your
  agent's credential resolution to whoever did.
  Enroll against <vault-host>? [yes/no] yes
Enrolled against vault https://<vault-host>
Vault ID <vault-id>
Config /path/to/clavitor.conf
Try: clavitor-proxy ca > ca.pem   then   clavitor-proxy serve

Wat er net gebeurde: de blob is lokaal ontsleuteld met de sleutel (geen netwerkaanroep), en het kluisadres + de identiteit van de agent + de sleutel voor het ontsleutelen van inloggegevens zijn weggeschreven naar een versleuteld bestand, clavitor.conf, naast het binaire bestand (modus 0600). Je hebt de blob of de sleutel daarna niet meer nodig. Als de invoer wordt gepiped in plaats van getypt, kan de hostbevestiging niet worden beantwoord; stel dan eerst CLAVITOR_PROXY_CONFIRM_VAULT=<vault-host> in.

3. Exporteer de root CA van de proxy. De proxy zal elke HTTPS-verbinding die je AI-agent maakt beëindigen en voor elke upstream host on-the-fly een certificaat opnieuw uitgeven. Zonder de root CA te vertrouwen, zouden die certificaten de verificatie niet doorstaan:

$ ./clavitor-proxy-linux-amd64 ca > clavitor-proxy-ca.pem

4. Installeer de CA in de systeem trust store. Op Debian/Ubuntu en afgeleiden:

$ sudo cp clavitor-proxy-ca.pem /usr/local/share/ca-certificates/clavitor-proxy-ca.crt
$ sudo update-ca-certificates

update-ca-certificates zou 1 added moeten afdrukken. Vanaf hier accepteert elke HTTPS-client op de machine (curl, Python's requests, Go's net/http, etc.) de certificaten van de proxy als legitiem.

5. Start de proxy. Deze koppelt aan 127.0.0.1:1983 en draait op de voorgrond; Ctrl-C stopt deze:

$ ./clavitor-proxy-linux-amd64 serve
clavitor-proxy <version> listening on 127.0.0.1:1983
Point your agent at:  HTTPS_PROXY=http://clavitor:<token>@127.0.0.1:1983
  Token redacted above; it is stored 0600 at /path/to/proxy-auth.
  e.g.  export HTTPS_PROXY="http://clavitor:$(cat /path/to/proxy-auth)@127.0.0.1:1983"

Voor een permanente setup, plaats een systemd-unit die naar dezelfde binary wijst, zodat deze opnieuw opstart na een reboot — zie de proxy-documentatie voor een referentie-unit.

6. Wijs je agent naar de proxy en controleer de hele keten. In een andere shell, in de map met het binaire bestand (het bestand proxy-auth daar is het toegangstoken van de proxy; serve print deze regel):

$ export HTTPS_PROXY="http://clavitor:$(cat proxy-auth)@127.0.0.1:1983"
$ curl -H "Authorization: Bearer clavitor://OpenAI/key" https://api.openai.com/v1/models

Wat daadwerkelijk de proxy verlaat en de servers van OpenAI bereikt — het verzoek dat je AI-agent nooit ziet:

GET /v1/models HTTP/1.1
Host: api.openai.com
Authorization: Bearer sk-proj-abc123def456ghi789…    ← real key, injected by the proxy
User-Agent: curl/8.4.0

Als je een JSON-antwoord van OpenAI terugkrijgt, is alles correct ingesteld. De proxy heeft clavitor://OpenAI/key opgelost tegen de kluis met behulp van de ontsleutelingssleutel voor inloggegevens uit stap 2, de echte sleutel vervangen in de Authorization-header, en het verzoek doorgestuurd. Je AI-agent-code bevat alleen de placeholder; de echte sleutel verlaat nooit het procesgeheugen van de proxy.

macOS

De onderstaande walkthrough gebruikt zsh (de standaard shell op macOS) en gaat uit van Apple Silicon; vervang amd64 door arm64 als je op een Intel Mac zit.

1. Download de proxy-binary en maak deze uitvoerbaar. Een enkele, zelfstandige binary, geen afhankelijkheden:

$ curl -LO https://clavitor.ai/downloads/clavitor-proxy-darwin-arm64
$ chmod +x clavitor-proxy-darwin-arm64

Als macOS Gatekeeper de binary de eerste keer weigert uit te voeren, klik er dan met de rechtermuisknop op in Finder, kies Open, en bevestig — dat registreert de uitzondering. Daarna werkt de aanroep vanaf de commandoregel.

2. Het binaire bestand staat op schijf. Koppel het nu aan je kluis. De proxy leest de blob en de sleutel van stdin (nooit van de opdrachtregel, zodat ze niet in je shellgeschiedenis lekken). Plak elk uit "Voordat je begint" wanneer daarom wordt gevraagd (de sleutel wordt niet weergegeven) en bevestig daarna de kluishost die je te zien krijgt:

$ ./clavitor-proxy-darwin-arm64 init
Paste enrollment blob, then press Enter:
<paste-the-blob-here>
Enrollment key:
<paste-the-key-here>

  This token enrolls the agent against vault:

      <vault-host>

  Your key authenticated the blob — NOT this host. If you did not get
  this blob from your own vault operator, answering yes hands your
  agent's credential resolution to whoever did.
  Enroll against <vault-host>? [yes/no] yes
Enrolled against vault https://<vault-host>
Vault ID <vault-id>
Config /path/to/clavitor.conf
Try: clavitor-proxy ca > ca.pem   then   clavitor-proxy serve

Wat er net gebeurde: de blob is lokaal ontsleuteld met de sleutel (geen netwerkaanroep), en het kluisadres + de identiteit van de agent + de sleutel voor het ontsleutelen van inloggegevens zijn weggeschreven naar een versleuteld bestand, clavitor.conf, naast het binaire bestand (modus 0600). Je hebt de blob of de sleutel daarna niet meer nodig. Als de invoer wordt gepiped in plaats van getypt, kan de hostbevestiging niet worden beantwoord; stel dan eerst CLAVITOR_PROXY_CONFIRM_VAULT=<vault-host> in.

3. Exporteer de root CA van de proxy. De proxy zal elke HTTPS-verbinding die je AI-agent maakt beëindigen en voor elke upstream host on-the-fly een certificaat opnieuw uitgeven. Zonder de root CA te vertrouwen, zouden die certificaten de verificatie niet doorstaan:

$ ./clavitor-proxy-darwin-arm64 ca > clavitor-proxy-ca.pem

4. Installeer de CA in de System Keychain. Eén commando, vraagt om je sudo-wachtwoord:

$ sudo security add-trusted-cert -d -r trustRoot \
    -k /Library/Keychains/System.keychain clavitor-proxy-ca.pem

Hierna accepteren Safari, curl, Swift, Python, Go en de meeste andere HTTPS-clients op de machine de certificaten van de proxy. (Een klein aantal runtime-omgevingen van talen heeft een eigen trust bundle en heeft aparte configuratie nodig — je ziet dan een certificaatfout.)

5. Start de proxy. Deze koppelt aan 127.0.0.1:1983 en draait op de voorgrond; Ctrl-C stopt deze:

$ ./clavitor-proxy-darwin-arm64 serve
clavitor-proxy <version> listening on 127.0.0.1:1983
Point your agent at:  HTTPS_PROXY=http://clavitor:<token>@127.0.0.1:1983
  Token redacted above; it is stored 0600 at /path/to/proxy-auth.
  e.g.  export HTTPS_PROXY="http://clavitor:$(cat /path/to/proxy-auth)@127.0.0.1:1983"

Voor een permanente setup, installeer het als een launchd-agent zodat het bij het inloggen start en opnieuw opstart bij een crash.

6. Wijs je agent naar de proxy en controleer de hele keten. In een andere shell, in de map met het binaire bestand (het bestand proxy-auth daar is het toegangstoken van de proxy; serve print deze regel):

$ export HTTPS_PROXY="http://clavitor:$(cat proxy-auth)@127.0.0.1:1983"
$ curl -H "Authorization: Bearer clavitor://OpenAI/key" https://api.openai.com/v1/models

Wat daadwerkelijk de proxy verlaat en de servers van OpenAI bereikt — het verzoek dat je AI-agent nooit ziet:

GET /v1/models HTTP/1.1
Host: api.openai.com
Authorization: Bearer sk-proj-abc123def456ghi789…    ← real key, injected by the proxy
User-Agent: curl/8.4.0

Als je een JSON-antwoord van OpenAI terugkrijgt, is alles correct ingesteld. De proxy heeft clavitor://OpenAI/key opgelost tegen de kluis met behulp van de ontsleutelingssleutel voor inloggegevens uit stap 2, de echte sleutel vervangen in de Authorization-header, en het verzoek doorgestuurd. Je AI-agent-code bevat alleen de placeholder; de echte sleutel verlaat nooit het procesgeheugen van de proxy.

Windows

De onderstaande walkthrough gebruikt PowerShell en gaat uit van 64-bits Windows; vervang windows-386.exe door windows-amd64.exe als je op 32-bits zit.

1. Download de proxy-binary. Een enkele, zelfstandige .exe, geen afhankelijkheden:

> Invoke-WebRequest https://clavitor.ai/downloads/clavitor-proxy-windows-amd64.exe `
    -OutFile clavitor-proxy.exe

Windows SmartScreen kan een waarschuwing tonen de eerste keer dat je een niet-ondertekende binary uitvoert — klik op Meer info → Toch uitvoeren om dit toe te staan.

2. Het binaire bestand staat op schijf. Koppel het nu aan je kluis. De proxy leest de blob en de sleutel van stdin (nooit van de opdrachtregel, zodat ze niet in je PowerShell-geschiedenis lekken). Plak elk uit "Voordat je begint" wanneer daarom wordt gevraagd (de sleutel wordt niet weergegeven) en bevestig daarna de kluishost die je te zien krijgt:

> .\clavitor-proxy.exe init
Paste enrollment blob, then press Enter:
<paste-the-blob-here>
Enrollment key:
<paste-the-key-here>

  This token enrolls the agent against vault:

      <vault-host>

  Your key authenticated the blob — NOT this host. If you did not get
  this blob from your own vault operator, answering yes hands your
  agent's credential resolution to whoever did.
  Enroll against <vault-host>? [yes/no] yes
Enrolled against vault https://<vault-host>
Vault ID <vault-id>
Config C:\path\to\clavitor.conf
Try: clavitor-proxy ca > ca.pem   then   clavitor-proxy serve

Wat er net gebeurde: de blob is lokaal ontsleuteld met de sleutel (geen netwerkaanroep), en het kluisadres + de identiteit van de agent + de sleutel voor het ontsleutelen van inloggegevens zijn weggeschreven naar een versleuteld bestand, clavitor.conf, naast het binaire bestand. Je hebt de blob of de sleutel daarna niet meer nodig. Als de invoer wordt gepiped in plaats van getypt, kan de hostbevestiging niet worden beantwoord; stel dan eerst CLAVITOR_PROXY_CONFIRM_VAULT=<vault-host> in.

3. Exporteer de root CA van de proxy. De proxy zal elke HTTPS-verbinding die je AI-agent maakt beëindigen en voor elke upstream host on-the-fly een certificaat opnieuw uitgeven. Zonder de root CA te vertrouwen, zouden die certificaten de verificatie niet doorstaan:

> .\clavitor-proxy.exe ca > clavitor-proxy-ca.pem

4. Installeer de CA in de Local Machine Trusted Root store. Open een verhoogde PowerShell (Rechtsklik op PowerShell → Als administrator uitvoeren) en voer uit:

> certutil -addstore -f "ROOT" clavitor-proxy-ca.pem

Hierna accepteren Edge, .NET, curl.exe en de meeste HTTP-clients op de machine de certificaten van de proxy. (Firefox onderhoudt zijn eigen trust store; als je via Firefox test, importeer de CA dan apart onder Instellingen → Privacy & Beveiliging → Certificaten → Certificaten weergeven → Autoriteiten → Importeren.)

5. Start de proxy. Deze koppelt aan 127.0.0.1:1983 en draait op de voorgrond; Ctrl-C stopt deze:

> .\clavitor-proxy.exe serve
clavitor-proxy <version> listening on 127.0.0.1:1983
Point your agent at:  HTTPS_PROXY=http://clavitor:<token>@127.0.0.1:1983
  Token redacted above; it is stored 0600 at C:\path\to\proxy-auth.
  e.g.  export HTTPS_PROXY="http://clavitor:$(cat C:\path\to\proxy-auth)@127.0.0.1:1983"

Voor een permanente setup, registreer het als een Windows-service of geplande taak, zodat het bij het opstarten start.

6. Wijs je agent naar de proxy en controleer de hele keten. In een ander PowerShell-venster, in de map met het binaire bestand (het bestand proxy-auth daar is het toegangstoken van de proxy):

> $env:HTTPS_PROXY = "http://clavitor:$(Get-Content proxy-auth)@127.0.0.1:1983"
> curl.exe -H "Authorization: Bearer clavitor://OpenAI/key" `
    https://api.openai.com/v1/models

(Gebruik expliciet curl.exe — de curl-alias van PowerShell wijst naar Invoke-WebRequest, die de proxy-omgevingsvariabele anders behandelt.) Wat daadwerkelijk de proxy verlaat en de servers van OpenAI bereikt — het verzoek dat je AI-agent nooit ziet:

GET /v1/models HTTP/1.1
Host: api.openai.com
Authorization: Bearer sk-proj-abc123def456ghi789…    ← real key, injected by the proxy
User-Agent: curl/8.4.0

Als je een JSON-antwoord van OpenAI terugkrijgt, is alles correct ingesteld. De proxy heeft clavitor://OpenAI/key opgelost tegen de kluis met behulp van de ontsleutelingssleutel voor inloggegevens uit stap 2, de echte sleutel vervangen in de Authorization-header, en het verzoek doorgestuurd. Je AI-agent-code bevat alleen de placeholder; de echte sleutel verlaat nooit het procesgeheugen van de proxy.

Installeer de Claude Code skill

De CLI wordt geleverd met een ingebouwde skill-definitie die Claude Code leert hoe je kluis te gebruiken. Eén commando installeert deze.

# Install globally (all projects)
$ clavitor-cli skill > ~/.claude/skills/clavitor.md

# Or install for a specific project
$ clavitor-cli skill > /path/to/project/.claude/skills/clavitor.md

De skill is ingebed in de binary. Werk deze bij door een nieuwe release te downloaden.

Gebruik het

Je AI-agent kan nu inloggegevens ophalen, TOTP-codes genereren en nieuwe geheimen opslaan. Elke toegang wordt gelogd in het auditlog van de kluis.

# Fetch a credential
$ clavitor-cli get github

# Generate a TOTP code
$ clavitor-cli totp github

# Store a new credential
$ clavitor-cli put credential "AWS Prod" --username admin --password s3cret

# List all entries
$ clavitor-cli list