docs(readme): refresh local guard positioning by michiosw · Pull Request #130 · kontext-security/kontext-cli

michiosw · 2026-05-14T16:28:49Z

Updates the README to lead with the local Guard story instead of hosted credentials.

replaces the banner with the new asset
reframes the repo around local safety, deterministic policy, probabilistic risk, and dashboard diagnostics
keeps managed sessions as an optional team layer with enterprise contact info

This README is slightly ahead of the current implementation because it reflects the launch direction. That is intentional for this positioning pass.

michiosw · 2026-05-14T16:29:03Z

feat(cli): make kontext start local-first #140
docs(readme): refresh local guard positioning #130 👈 (View in Graphite)
main

This stack of pull requests is managed by Graphite. Learn more about stacking.

greptile-apps · 2026-05-14T16:30:11Z

Greptile Summary

This PR refreshes the README to reposition Kontext CLI as a "local safety runtime" with a clear Guard-first narrative, replacing the previous mode-centric structure. The banner SVG is updated to match the new messaging.

The "What is Kontext CLI?" section is rewritten; the "Operating Modes", "Managed Credentials", and "Providers and Traces" sections are removed and replaced with a simpler "Local Guard" command table and an "Optional Team Layer" section.
Security bullet points are simplified to reflect the current Guard-focused feature set; the architecture diagram drops the hosted-mode block.
The PR description template was left unfilled (placeholder text and unchecked verification boxes remain).

Confidence Score: 5/5

Documentation-only change with no code, logic, or config touched — safe to merge.

Both changed files are purely presentational: the README prose and a banner SVG. No executable code, migrations, or API contracts are affected. The only minor gap is an unfilled PR description template, but that has no impact on the shipped artifact.

No files require special attention.

Important Files Changed

Filename	Overview
README.md	Documentation refresh: rewrites product description to focus on local safety runtime, replaces the Operating Modes/Managed Credentials/Providers sections with simpler Local Guard and Optional Team Layer sections, and removes the tagline paragraph below the banner.
assets/banner-cli.svg	Banner SVG updated — likely reflects new tagline/positioning text to match the README refresh; no code or logic concerns.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[README.md] --> B[What is Kontext CLI?]
    A --> C[Quick Start]
    A --> D[Local Guard]
    A --> E[What You Get]
    A --> F[Optional Team Layer]
    A --> G[Security]
    A --> H[Supported Agents]
    A --> I[Architecture]

    B -->|"Removed"| B1["'guardrails + scoped credentials' tagline"]
    B -->|"Added"| B2["'local safety runtime' description"]
    D -->|"Replaced"| D1["Operating Modes table"]
    E -->|"Replaced"| E1["Feature capability table"]
    F -->|"Replaced"| F1["Managed Credentials + Providers sections"]
    I -->|"Removed"| I1["Hosted mode architecture block"]

_{Reviews (1): Last reviewed commit: "docs(readme): refresh local guard positi..." | Re-trigger Greptile}

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 40fd75e23b

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: bc6ab1a90b

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 6bf4e9c94b

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector · 2026-05-16T08:29:21Z