Blocca le azioni rischiose degli agenti AI prima che vengano eseguite

Gli agenti AI non si limitano a suggerire codice. Eseguono comandi shell, leggono file, chiamano servizi, modificano infrastrutture e interagiscono con sistemi di produzione.

Kontext inserisce una policy locale tra gli agenti AI e gli strumenti che chiamano. Osserva le azioni supportate, valuta la policy prima che vengano eseguite azioni consequenziali e registra la decisione e l'esito in un registro di autorizzazione.

Inizia in modalità osservazione. Scopri cosa bloccherebbe la policy. Passa i confini supportati all'applicazione quando sei pronto.

Gli errori di valutazione della policy consentono la chiamata allo strumento, anche in modalità enforce, e rimangono visibili come errori nel registro delle attività. I dinieghi completati dalla policy e le approvazioni richieste non disponibili continuano a bloccare. Questo fallback in caso di errore non modifica il comportamento quando il daemon non è disponibile o l'applicazione non ha una policy utilizzabile.

• Decisioni locali: la valutazione della policy avviene accanto all'agente.
• Applicazione pre-azione: le azioni corrispondenti possono essere negate negli hook sincroni supportati.
• Nessun comando wrapper: installa Kontext una volta e continua a usare i tuoi agenti normalmente.
• Evidenza attribuibile: conserva l'agente, la sessione, l'azione, la decisione della policy e l'esito.
• Distribuzione gestita: distribuisci la policy e rivedi i record redatti in tutta l'organizzazione.

Kontext attualmente supporta Claude Code, Claude Cowork e Codex. La copertura esatta degli eventi e dell'applicazione varia in base all'agente—vedi la matrice di supporto degli agenti.

Gli hook gestiti di Claude riconoscono le sessioni Cowork con nomi di directory di sessione completi o abbreviati, preservando la loro identità Cowork nei record delle attività.

Avvio rapido

Installa Kontext

brew install kontext-security/tap/kontext

Connetti questo Mac

Crea un token di installazione nella dashboard Kontext, poi esegui:

kontext setup

Setup:

• memorizza il token di installazione nel portachiavi di login di macOS;
• installa gli hook per gli agenti supportati;
• avvia il daemon locale di Kontext;
• connette l'installazione alla tua organizzazione Kontext.

Verifica l'installazione:

kontext doctor

Poi continua a usare Claude Code o Codex normalmente. Non è necessario avviare l'agente tramite un wrapper separato.

Il setup self-serve attualmente supporta macOS. Gli ambienti gestiti e cloud possono eseguire lo stesso runtime locale quando forniscono un contratto di hook supportato, storage e ciclo di vita del daemon.

Cosa cambia dopo il setup?

Senza una policy pre-azione, un'azione dell'agente viene eseguita prima che un team di sicurezza possa rivederne i log:

agent requests an action
        |
        v
action executes
        |
        v
activity appears in a log

Con Kontext:

agent requests an action
        |
        v
Kontext receives it through a supported hook
        |
        v
local policy evaluates the action
        |
        +---- allow ----------> action continues
        |
        +---- would deny -----> action continues and evidence is recorded
        |                       (observe mode)
        |
        +---- deny -----------> action is stopped before execution
                                (enforce mode)
        |
        v
decision and outcome enter the authorization ledger

Questo crea un punto decisionale prima dell'azione, non solo un record dopo di essa.

Prima osserva. Applica quando sei pronto.

Bloccare ogni azione sconosciuta il primo giorno crea rumore e interrompe gli sviluppatori. Consentire ogni azione a tempo indefinito lascia la policy come monitoraggio passivo.

Kontext separa la distribuzione in due modalità:

Modalità osservazione

La modalità osservazione registra la decisione della policy senza interrompere l'agente.

Usala per rispondere a:

• Quali strumenti stanno chiamando gli agenti?
• Quali azioni negherebbe la policy attuale?
• Quali repository, file e sistemi sono coinvolti?
• Dove interromperebbe il lavoro legittimo l'applicazione?
• Quali superfici di eventi possono effettivamente fermare l'azione?

Modalità enforce

La modalità enforce restituisce un diniego reale quando una policy deterministica corrisponde a un hook pre-azione sincrono supportato.

Le policy possono definire confini attorno ad azioni come:

• comandi distruttivi;
• accesso a file sensibili;
• operazioni su sistemi di produzione;
• accesso a credenziali;
• esportazioni di dati.

L'applicazione è intenzionalmente limitata alle superfici di eventi in cui l'agente attende Kontext prima di continuare. Kontext non pretende che ricevere un evento significhi poter fermare ogni azione di quell'agente.

Sappi cosa è successo—e perché

Ogni evento supportato che raggiunge Kontext può contribuire con evidenza al registro di autorizzazione locale.

Un record può includere:

• l'agente e la sessione;
• l'evento di ciclo di vita o dello strumento;
• il nome dello strumento e l'input disponibile;
• la decisione della policy locale;
• la policy responsabile di quella decisione;
• l'esito dell'azione disponibile;
• evidenza redatta per revisione successiva.

Kontext registra l'attività degli strumenti e l'evidenza delle decisioni. Non cattura il ragionamento del modello né ricostruisce la cronologia completa della conversazione.

Le distribuzioni gestite possono esportare record redatti nella dashboard Kontext per revisione, conservazione e indagine a livello organizzativo.

Policy dove viene eseguito l'agente

Il percorso decisionale rimane locale:

Claude Code / Cowork / Codex
              |
              v
        supported hook
              |
              v
     local Kontext runtime
              |
        +-----+------+
        |            |
        v            v
  policy decision   local ledger
        |
        v
 allow / would deny / deny

Un servizio ospitato non deve rispondere a ogni chiamata di strumento.

Le distribuzioni gestite aggiungono configurazione organizzativa, distribuzione della policy, esportazione dei record, identità e conservazione. Non spostano il percorso decisionale sincrono fuori dall'ambiente dell'agente.

Agenti supportati

"Supportato" significa più che accettare un evento. Kontext documenta quali eventi riceve, quali eventi possono bloccare e come viene installata ogni integrazione.

Vedi la matrice di supporto degli agenti per il comportamento esatto, l'ambito di distribuzione e le lacune note. È la fonte autorevole per la copertura dell'applicazione.

Kontext e le sandbox risolvono problemi diversi

Una sandbox di processo chiede:

A quali file, destinazioni di rete, credenziali e risorse del sistema operativo può accedere questo processo?

Kontext chiede:

Quale agente sta tentando quale azione, quale policy si applica, l'azione deve procedere e quale evidenza prova la decisione?

Le sandbox del kernel sono forti confini di contenimento. Kontext fornisce policy semantica e attribuzione negli hook supportati di agenti e strumenti.

Sono complementari:

Kontext
  decides whether the action is authorized
              |
              v
sandbox
  constrains what the process can physically access

Kontext non pretende l'isolamento a livello di kernel. Usa una sandbox appropriata quando il modello di minaccia richiede contenimento di processo, filesystem o rete.

Perché non limitarsi a raccogliere i log degli agenti?

I log ti dicono cosa ha segnalato un agente dopo un evento.

Kontext crea una decisione di autorizzazione prima che vengano eseguite le azioni consequenziali supportate, poi collega quella decisione all'esito disponibile.

Questa distinzione è importante durante:

• la distribuzione della policy;
• l'indagine su incidenti;
• la revisione dell'accesso alla produzione;
• la gestione delle eccezioni degli sviluppatori;
• la revisione di conformità e audit.

Il risultato non è solo "l'agente ha chiamato uno strumento". È evidenza di cosa è stato richiesto, quale policy si è applicata, se è stato consentito e cosa è successo dopo.

Esegui Kontext in tutta la tua organizzazione

Le distribuzioni gestite aggiungono:

• policy deterministica gestita centralmente;
• identità aziendale e controlli organizzativi;
• distribuzione da osservazione ad applicazione;
• supporto per la distribuzione gestita di agenti e cloud;
• esportazione di evidenza redatta;
• conservazione per audit;
• monitoraggio dello stato di salute della distribuzione e del backlog;
• onboarding per i team di sicurezza e piattaforma.

Per la pianificazione della distribuzione e l'onboarding dell'organizzazione, contatta [email protected] o prenota una conversazione.

Diagnostica un'installazione

kontext doctor

doctor verifica:

• gli hook degli agenti installati;
• lo stato di salute e la versione del daemon;
• lo stato di salute dell'esportazione gestita;
• il backlog di esportazione in sospeso.

Esce con codice diverso da zero quando un'installazione configurata non è in salute.

Quando un daemon self-serve è obsoleto:

kontext doctor --fix

Ruota il token di installazione eseguendo di nuovo il setup:

kontext setup

Rimuovi l'installazione self-serve:

kontext setup --uninstall

Gestione dei dati

• Le decisioni della policy avvengono localmente.
• L'attività degli strumenti e l'evidenza delle decisioni sono archiviate localmente.
• I valori sensibili vengono redatti prima dell'archiviazione locale e dell'esportazione gestita.
• Kontext non memorizza il ragionamento del modello né la cronologia completa della conversazione.
• Le distribuzioni gestite possono esportare record redatti nella dashboard dell'organizzazione.

Vedi la documentazione di Guard per il runtime e il confine dei dati.

Sviluppo

go build -o bin/kontext ./cmd/kontext
go test ./...
go test -race ./...
go vet ./...

Community

• Leggi SUPPORT.md per i canali di supporto.
• Leggi CONTRIBUTING.md prima di aprire un contributo.
• Segnala le vulnerabilità attraverso la nostra Security Policy.
• Kontext è rilasciato sotto la MIT License.

Report sull'autorità

kontext report mostra gli agenti e l'autorità scoperti esattamente come accettati l'ultima volta dal cloud. Usa kontext report --json per il payload grezzo. Prima del primo invio riuscito, non riporta alcun dato.

Imposta KONTEXT_AUTHORITY_SCAN=off nell'ambiente del daemon per disabilitare la raccolta e la trasmissione dell'autorità su questo Mac.