kontext-cli

O Kontext é uma plataforma de autorização para agentes de IA. Ele ajuda equipes a controlar o que os agentes podem acessar e fazer com credenciais com escopo, aplicação de políticas, aprovações e trilhas de auditoria. O Kontext pode ser executado local-first para agentes de desenvolvimento e se estender a implantações gerenciadas ou auto-hospedadas para ambientes sensíveis à segurança.

Início rápido

brew install kontext-security/tap/kontext

Conecte sua máquina ao seu workspace

Use a configuração self-serve para transmitir a atividade do agente da sua máquina para o dashboard Kontext da sua equipe.

Gere um token de instalação na página Deployments do seu workspace e execute:

kontext setup

Execute kontext setup novamente para rotacionar o token armazenado. Execute kontext setup --uninstall para remover a configuração de nível de usuário, hooks, LaunchAgent e token do chaveiro que a configuração instalou; os logs locais e os dados de observação são mantidos, e os hooks gerenciados pela organização permanecem no lugar. A configuração self-serve atualmente é somente para macOS.

Execute kontext doctor para inspecionar a versão do daemon, o heartbeat e o backlog de exportação. Ao atualizar a partir de uma versão anterior à recuperação automática de binários obsoletos, execute kontext doctor --fix uma vez se o doctor relatar uma versão antiga ou desconhecida do daemon; as atualizações subsequentes via Homebrew reiniciam o daemon automaticamente.

Recursos principais

O Kontext equilibra segurança e utilidade para agentes de IA: ações de baixo risco continuam fluindo, e ações inseguras podem ser bloqueadas antes de serem executadas.

• Trilhas de auditoria: Registram quem instruiu qual agente a fazer o quê, o que o agente acessou, quais ferramentas chamou, quais decisões de política foram tomadas e o que aconteceu depois. Construa uma cadeia de custódia para revisão de segurança, investigação de incidentes e evidências de conformidade.
• Política determinística: Aplique regras allow e deny às ações do agente em tempo de execução, antes que elas sejam executadas. Use políticas rígidas para limites conhecidos, como comandos destrutivos, recursos de produção, arquivos sensíveis, exportações de dados e acesso a credenciais.
• Detecção probabilística de risco: Encaminhe as ações que a política determinística permite por um juiz local para uma decisão adicional de allow/deny, sem enviar o contexto da ferramenta a serviços hospedados.
• Injeção de credenciais: Injete credenciais OAuth com escopo em tempo de execução usando o Token Exchange OAuth 2.0 compatível com a RFC 8693, para que os agentes possam acessar ferramentas aprovadas sem que os usuários colem segredos em chats, arquivos de configuração ou ambientes de projeto. As credenciais podem ser de curta duração, com privilégio mínimo e vinculadas ao usuário, sessão ou fluxo de trabalho atuais.

O caminho de decisão é:

Agent tool call
  -> agent hook
  -> daemon
  -> action classification
  -> deterministic policy
  -> probabilistic risk score
  -> allow / deny
  -> hosted dashboard stream

Implantações gerenciadas

Para identidade corporativa, retenção de auditoria, controles organizacionais, planejamento de implantação, volume de uso personalizado e onboarding para equipes de segurança e plataforma, entre em contato com [email protected] ou agende aqui.

Padrões de segurança

Suporte a agentes

Agentes adicionais podem ser adicionados por meio de adaptadores que enviam eventos de ferramentas compatíveis para o runtime local.

Arquitetura

kontext setup
  |
  |-- User managed config: ~/Library/Application Support/Kontext/managed.json
  |-- Agent integration: hooks or observer
  |     |-- PreToolUse  -> kontext hook pre-tool-use
  |     |-- PostToolUse -> kontext hook post-tool-use
  |
  |-- LaunchAgent: security.kontext.managed-observe
  |-- Daemon: Unix socket service + RuntimeCore
  |-- Deterministic policy: curated rule categories + active profile
  |-- Probabilistic risk: local allow/deny decision after deterministic allow
  |-- Store: local SQLite with redacted events and decision metadata
  |-- Stream: governed activity to the hosted workspace dashboard

Desenvolvimento

go build -o bin/kontext ./cmd/kontext
go test ./...
go test -race ./...
go vet ./...
pnpm install --frozen-lockfile
pnpm build

Gere o código protobuf com:

buf generate

As definições de serviço estão em kontext-security/proto agent.proto.

Comunidade

• Leia SUPPORT.md para conhecer os canais de suporte.
• Leia CONTRIBUTING.md antes de abrir uma contribuição.
• O Kontext CLI é distribuído sob a Licença MIT.