kontext-cli

Kontext は AI エージェント向けの認可プラットフォームです。スコープ付き認証情報、ポリシー適用、承認、監査トレイルを通じて、エージェントがアクセスおよび実行できる内容をチームが制御できるようにします。Kontext は開発者エージェント向けにローカルファーストで動作し、セキュリティに敏感な環境向けにマネージドまたはセルフホスト型デプロイメントへ拡張できます。

クイックスタート

brew install kontext-security/tap/kontext

マシンをワークスペースに接続する

セルフサービスセットアップを使用して、マシン上のエージェントアクティビティをチームの Kontext ダッシュボードにストリーミングします。

ワークスペースの Deployments ページでインストールトークンを生成し、次を実行します:

kontext setup

kontext setup を再実行すると、保存されたトークンをローテーションできます。kontext setup --uninstall を実行すると、セットアップがインストールしたユーザーレベルの設定、フック、LaunchAgent、キーチェーントークンが削除されます。ローカルログと監視データは保持され、組織管理のフックはそのまま残ります。セルフサービスセットアップは現在 macOS のみ対応です。

kontext doctor を実行すると、デーモンのバージョン、ハートビート、エクスポートバックログを検査できます。自動的な古いバイナリの回復より前のリリースからアップグレードする場合、doctor が古いまたは不明なデーモンバージョンを報告したら、kontext doctor --fix を一度実行してください。その後の Homebrew アップグレードでは、デーモンが自動的に再起動されます。

コア機能

Kontext は AI エージェント向けにセキュリティと実用性のバランスを取ります。低リスクのアクションはそのまま実行され、安全でないアクションは実行前にブロックできます。

• 監査トレイル: どのユーザーがどのエージェントに何をするよう指示したか、エージェントが何にアクセスしたか、どのツールを呼び出したか、どのようなポリシー決定が行われたか、その後に何が起こったかを記録します。セキュリティレビュー、インシデント調査、コンプライアンス証拠のための証拠保管チェーンを構築します。
• 決定論的ポリシー: 実行前にランタイムでエージェントのアクションに allow ルールと deny ルールを適用します。破壊的なコマンド、本番リソース、機密ファイル、データ書き出し、認証情報アクセスなど、既知の境界にはハードポリシーを使用します。
• 確率的リスク検出: 決定論的ポリシーが許可したアクションを、ホスト型サービスにツールコンテキストを送信せずに、追加の allow/deny 判定のためローカル判定モデルにルーティングします。
• 認証情報の注入: RFC 8693 準拠の OAuth 2.0 Token Exchange を使用して、ランタイムでスコープ付き OAuth 認証情報を注入します。これにより、ユーザーがチャット、設定ファイル、プロジェクト環境にシークレットを貼り付けなくても、エージェントは承認されたツールにアクセスできます。認証情報は短命で最小特権にし、現在のユーザー、セッション、またはワークフローにバインドできます。

決定パスは次のとおりです:

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

マネージドデプロイメント

エンタープライズ向けのアイデンティティ、監査保持、組織コントロール、デプロイメント計画、カスタム利用量、セキュリティチームとプラットフォームチームのオンボーディングについては、[email protected] まで連絡するか、こちらから予約 してください。

セキュリティのデフォルト

エージェントサポート

互換性のあるツールイベントをローカルランタイムに送信するアダプターを通じて、追加のエージェントを追加できます。

アーキテクチャ

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

開発

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

protobuf コードは次のコマンドで生成します:

buf generate

サービス定義は kontext-security/proto agent.proto にあります。

コミュニティ

• サポートチャネルについては SUPPORT.md をお読みください。
• コントリビューションを行う前に CONTRIBUTING.md をお読みください。
• Kontext CLI は MIT ライセンス の下でリリースされています。