Skip to content

Releases

PromptGuard CLI v2.6.0

Choose a tag to compare

@github-actions github-actions released this 15 Nov 20:11

PromptGuard CLI v2.6.0

Added

  • scan --json and the MCP promptguard_scan_project tool report
    has_api_key_header for each SDK instance
    : whether the call sets the
    X-API-Key header, the only place the proxy reads your PromptGuard key
    from. It is read from the call's literal headers, so a comment or value
    that mentions the name does not count, and it is null when the headers
    come from a variable, a splat or a spread the scan cannot see.
    has_base_url alone could not tell a client that works through the proxy
    from one that points at it and gets 401; the VS Code extension uses both to
    say which calls are protected.
    Drop-in LLM security for your applications - Built with Rust + Tree-sitter

Installation

One-line install (macOS/Linux):

curl -fsSL https://raw.githubusercontent.com/promptguardhq/promptguard-cli/main/install.sh | sh

Manual install:

  1. Download the binary for your platform below
  2. Make it executable: chmod +x promptguard-*
  3. Move to PATH: sudo mv promptguard-* /usr/local/bin/promptguard
  4. Verify: promptguard --version

Checksums

SHA256 checksums are provided for each binary (.sha256 files).

About PromptGuard CLI

  • ✅ Real AST transformations using Tree-sitter
  • ✅ TypeScript, JavaScript, Python support
  • ✅ OpenAI, Anthropic, Cohere, HuggingFace providers
  • ✅ Automatic backups with safe revert
  • ✅ Single 5.3MB static binary

Supported Platforms

  • macOS ARM64 (M1/M2/M3)
  • macOS x86_64 (Intel)
  • Linux x86_64
  • Windows x86_64

📖 Documentation: https://docs.promptguard.co/cli
🏠 Homepage: https://promptguard.co
🐛 Issues: https://github.com/promptguardhq/promptguard-cli/issues

PromptGuard CLI v2.5.2

Choose a tag to compare

@github-actions github-actions released this 15 Nov 19:34

PromptGuard CLI v2.5.2

Fixed

  • Clients rewritten by init and apply now authenticate to the proxy.
    The rewrite added the proxy base URL but never the X-API-Key header, the
    only place the proxy reads your PromptGuard key from, so every rewritten
    client got 401 missing_api_key. It now adds default_headers (Python) or
    defaultHeaders (TypeScript) carrying the key, and leaves your provider key
    where it was: a client with no arguments used to get your PromptGuard key as
    its provider key, which the proxy forwards to the provider, where it failed.
    A client an earlier version rewrote (the proxy URL, no header) gets the
    header added when you run init or apply again. Calls the rewrite cannot
    make work are left untouched and listed for manual routing: ones that
    already set headers or pass dynamic options (**cfg, ...cfg),
    cohere.Client, and the TypeScript Hugging Face and Cohere clients.
  • Anthropic clients rewritten by init and apply now reach the proxy.
    The rewrite used the /api/v1 proxy URL, but the Anthropic SDK appends
    /v1 itself, so requests went to /api/v1/v1/messages; and the SDK sends
    its key in X-Api-Key, the header the proxy reads your PromptGuard key
    from. The rewrite now uses the proxy URL without /v1, sends your
    PromptGuard key as X-API-Key, and moves your Anthropic key out of
    api_key / apiKey into Authorization: Bearer, which the proxy forwards
    to Anthropic. A client an earlier version rewrote is repaired when you run
    init or apply again. Calls that set auth_token, credentials,
    profile or headers of their own are listed for manual routing (#66). A
    client that took its credential from ANTHROPIC_AUTH_TOKEN, a profile or
    workload identity in the environment now sends ANTHROPIC_API_KEY instead:
    store your Anthropic key in PromptGuard as a provider key, which the proxy
    uses in place of the header.
    Drop-in LLM security for your applications - Built with Rust + Tree-sitter

Installation

One-line install (macOS/Linux):

curl -fsSL https://raw.githubusercontent.com/promptguardhq/promptguard-cli/main/install.sh | sh

Manual install:

  1. Download the binary for your platform below
  2. Make it executable: chmod +x promptguard-*
  3. Move to PATH: sudo mv promptguard-* /usr/local/bin/promptguard
  4. Verify: promptguard --version

Checksums

SHA256 checksums are provided for each binary (.sha256 files).

About PromptGuard CLI

  • ✅ Real AST transformations using Tree-sitter
  • ✅ TypeScript, JavaScript, Python support
  • ✅ OpenAI, Anthropic, Cohere, HuggingFace providers
  • ✅ Automatic backups with safe revert
  • ✅ Single 5.3MB static binary

Supported Platforms

  • macOS ARM64 (M1/M2/M3)
  • macOS x86_64 (Intel)
  • Linux x86_64
  • Windows x86_64

📖 Documentation: https://docs.promptguard.co/cli
🏠 Homepage: https://promptguard.co
🐛 Issues: https://github.com/promptguardhq/promptguard-cli/issues

PromptGuard CLI v2.5.1

Choose a tag to compare

@github-actions github-actions released this 14 Nov 09:02

PromptGuard CLI v2.5.1

Fixed

  • promptguard verify no longer fails against a healthy API. Its
    connectivity check asked for /api/v1/health, which the API does not serve
    (/health is at the host root), so verify reported API unreachable
    with a working key and exited 2, and whoami and test said the API was
    unreachable. CI jobs gated on verify --json, as the docs' GitHub Actions
    example is, failed on every run. The check now probes /health at the host
    root of your base URL; a base URL that does not end in /api/v1 is probed
    as given.
    Drop-in LLM security for your applications - Built with Rust + Tree-sitter

Installation

One-line install (macOS/Linux):

curl -fsSL https://raw.githubusercontent.com/promptguardhq/promptguard-cli/main/install.sh | sh

Manual install:

  1. Download the binary for your platform below
  2. Make it executable: chmod +x promptguard-*
  3. Move to PATH: sudo mv promptguard-* /usr/local/bin/promptguard
  4. Verify: promptguard --version

Checksums

SHA256 checksums are provided for each binary (.sha256 files).

About PromptGuard CLI

  • ✅ Real AST transformations using Tree-sitter
  • ✅ TypeScript, JavaScript, Python support
  • ✅ OpenAI, Anthropic, Cohere, HuggingFace providers
  • ✅ Automatic backups with safe revert
  • ✅ Single 5.3MB static binary

Supported Platforms

  • macOS ARM64 (M1/M2/M3)
  • macOS x86_64 (Intel)
  • Linux x86_64
  • Windows x86_64

📖 Documentation: https://docs.promptguard.co/cli
🏠 Homepage: https://promptguard.co
🐛 Issues: https://github.com/promptguardhq/promptguard-cli/issues

PromptGuard CLI v2.5.0

Choose a tag to compare

@github-actions github-actions released this 13 Nov 15:07

PromptGuard CLI v2.5.0

Added

  • The local MCP server's promptguard_redact takes pii_types, as the
    hosted tool does.
    Name the PII types to redact in the REST API's
    vocabulary (detector names such as email or phone_us, the aliases
    phone, ip_address and passport, and api_key); omit it and the
    Project's policy decides, as before. An unknown name is a tool error whose
    structured content is {"kind": "error", "error": ..., "code": "unknown_pii_type"}, the hosted server's shape, and nothing is redacted or
    counted. The tool's description and parameters are the hosted tool's again.

  • promptguard_redact results carry skipped. It lists the matches the
    API deliberately left in the text, such as an email at a domain reserved
    for documentation and testing (example.com, .test), with the reason
    reserved_domain. It is [] when nothing was skipped. An API from before
    the field sends none, and the tool then answers [] too, although that API
    may still have left a reserved-domain email in the text.

Security

  • The lockfile moves quinn-udp to 0.5.16 (RUSTSEC-2026-0538) and rustix
    to 1.1.6 (RUSTSEC-2026-0486).
    Neither was in the shipped binary:
    quinn-udp belongs to the HTTP client's HTTP/3 support, which the CLI does
    not enable, and rustix only to the test suite. The update keeps
    cargo audit clean.
    Drop-in LLM security for your applications - Built with Rust + Tree-sitter

Installation

One-line install (macOS/Linux):

curl -fsSL https://raw.githubusercontent.com/promptguardhq/promptguard-cli/main/install.sh | sh

Manual install:

  1. Download the binary for your platform below
  2. Make it executable: chmod +x promptguard-*
  3. Move to PATH: sudo mv promptguard-* /usr/local/bin/promptguard
  4. Verify: promptguard --version

Checksums

SHA256 checksums are provided for each binary (.sha256 files).

About PromptGuard CLI

  • ✅ Real AST transformations using Tree-sitter
  • ✅ TypeScript, JavaScript, Python support
  • ✅ OpenAI, Anthropic, Cohere, HuggingFace providers
  • ✅ Automatic backups with safe revert
  • ✅ Single 5.3MB static binary

Supported Platforms

  • macOS ARM64 (M1/M2/M3)
  • macOS x86_64 (Intel)
  • Linux x86_64
  • Windows x86_64

📖 Documentation: https://docs.promptguard.co/cli
🏠 Homepage: https://promptguard.co
🐛 Issues: https://github.com/promptguardhq/promptguard-cli/issues

PromptGuard CLI v2.4.1

Choose a tag to compare

@github-actions github-actions released this 10 Nov 09:31

PromptGuard CLI v2.4.1

Changed

  • Messages use plain punctuation. Warnings, hints and generated shim
    comments that used an em or en dash now use a comma or colon instead. The
    wording is otherwise unchanged.

  • The MCP tool manifest copy is refreshed, and held to the platform's.
    tests/mcp-tool-definitions.json now lists the hosted server's Read-stage
    tools and promptguard_propose_suppression. scripts/check_mcp_tool_manifest.py
    fails make ci and the pre-push hook when the copy is not byte-identical to
    the platform's origin/main, so it can no longer fall behind silently.
    Drop-in LLM security for your applications - Built with Rust + Tree-sitter

Installation

One-line install (macOS/Linux):

curl -fsSL https://raw.githubusercontent.com/promptguardhq/promptguard-cli/main/install.sh | sh

Manual install:

  1. Download the binary for your platform below
  2. Make it executable: chmod +x promptguard-*
  3. Move to PATH: sudo mv promptguard-* /usr/local/bin/promptguard
  4. Verify: promptguard --version

Checksums

SHA256 checksums are provided for each binary (.sha256 files).

About PromptGuard CLI

  • ✅ Real AST transformations using Tree-sitter
  • ✅ TypeScript, JavaScript, Python support
  • ✅ OpenAI, Anthropic, Cohere, HuggingFace providers
  • ✅ Automatic backups with safe revert
  • ✅ Single 5.3MB static binary

Supported Platforms

  • macOS ARM64 (M1/M2/M3)
  • macOS x86_64 (Intel)
  • Linux x86_64
  • Windows x86_64

📖 Documentation: https://docs.promptguard.co/cli
🏠 Homepage: https://promptguard.co
🐛 Issues: https://github.com/promptguardhq/promptguard-cli/issues

PromptGuard CLI v2.4.0

Choose a tag to compare

@github-actions github-actions released this 05 Nov 18:26

PromptGuard CLI v2.4.0

Added

  • promptguard mcp install adds PromptGuard's MCP server to every AI client
    on the machine.
    It finds Claude Code, Codex, Cursor, VS Code, Windsurf and
    Claude Desktop and adds the hosted server, https://api.promptguard.co/mcp,
    to each: through claude mcp add and codex mcp add for the first two, by
    merging one promptguard entry into the JSON config of the others, and, for
    Claude Desktop, which takes remote servers only as connectors, by printing
    the step to add one. --clients limits it to named clients, --dry-run
    shows what would change, --local installs the local stdio server instead
    and --url points at another server. It never replaces a config file: other
    entries, key order and indentation are kept, the write is atomic, the
    original is kept as <file>.bak, an entry pointing elsewhere is left alone
    without --force, and a file that is not valid JSON is reported and not
    touched. No API key is written; each client signs in to PromptGuard itself.
    Drop-in LLM security for your applications - Built with Rust + Tree-sitter

Installation

One-line install (macOS/Linux):

curl -fsSL https://raw.githubusercontent.com/promptguardhq/promptguard-cli/main/install.sh | sh

Manual install:

  1. Download the binary for your platform below
  2. Make it executable: chmod +x promptguard-*
  3. Move to PATH: sudo mv promptguard-* /usr/local/bin/promptguard
  4. Verify: promptguard --version

Checksums

SHA256 checksums are provided for each binary (.sha256 files).

About PromptGuard CLI

  • ✅ Real AST transformations using Tree-sitter
  • ✅ TypeScript, JavaScript, Python support
  • ✅ OpenAI, Anthropic, Cohere, HuggingFace providers
  • ✅ Automatic backups with safe revert
  • ✅ Single 5.3MB static binary

Supported Platforms

  • macOS ARM64 (M1/M2/M3)
  • macOS x86_64 (Intel)
  • Linux x86_64
  • Windows x86_64

📖 Documentation: https://docs.promptguard.co/cli
🏠 Homepage: https://promptguard.co
🐛 Issues: https://github.com/promptguardhq/promptguard-cli/issues

PromptGuard CLI v2.3.1

Choose a tag to compare

@github-actions github-actions released this 05 Nov 10:31

PromptGuard CLI v2.3.1

Fixed

  • Links to the dashboard's API keys page work again. promptguard key,
    init, login, test, the MCP server's promptguard_auth and
    install.sh sent you to https://app.promptguard.co/settings/api-keys,
    which does not exist, so the step that tells you where to get a key ended on
    a 404. They now link https://app.promptguard.co/dashboard/api-keys, and
    init's sign-up link goes to /register instead of the missing /signup.
    A test now fails on any dashboard link the dashboard does not serve.
    Drop-in LLM security for your applications - Built with Rust + Tree-sitter

Installation

One-line install (macOS/Linux):

curl -fsSL https://raw.githubusercontent.com/promptguardhq/promptguard-cli/main/install.sh | sh

Manual install:

  1. Download the binary for your platform below
  2. Make it executable: chmod +x promptguard-*
  3. Move to PATH: sudo mv promptguard-* /usr/local/bin/promptguard
  4. Verify: promptguard --version

Checksums

SHA256 checksums are provided for each binary (.sha256 files).

About PromptGuard CLI

  • ✅ Real AST transformations using Tree-sitter
  • ✅ TypeScript, JavaScript, Python support
  • ✅ OpenAI, Anthropic, Cohere, HuggingFace providers
  • ✅ Automatic backups with safe revert
  • ✅ Single 5.3MB static binary

Supported Platforms

  • macOS ARM64 (M1/M2/M3)
  • macOS x86_64 (Intel)
  • Linux x86_64
  • Windows x86_64

📖 Documentation: https://docs.promptguard.co/cli
🏠 Homepage: https://promptguard.co
🐛 Issues: https://github.com/promptguardhq/promptguard-cli/issues

PromptGuard CLI v2.3.0

Choose a tag to compare

@github-actions github-actions released this 04 Nov 19:11

PromptGuard CLI v2.3.0

Added

  • promptguard mcp speaks MCP 2026-07-28 and 2025-11-25. A 2026-07-28
    client needs no initialize: each request names its revision in _meta,
    server/discover answers with every revision the server speaks (2026-07-28,
    2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05), its capabilities and its
    identity, and a revision it does not speak gets -32022
    (UnsupportedProtocolVersionError) with that list. Those results carry
    resultType, the server's identity in _meta, and, for tools/list and
    server/discover, ttlMs and cacheScope; ping and logging/setLevel,
    which 2026-07-28 removed, are unknown methods there. Older clients still
    open with initialize, which now also agrees on 2025-11-25.
  • promptguard_scan_text takes content_type (prompt, the default, or
    response), so an agent can scan a model's output as well as a prompt. It is
    sent to the API as the scan type; any other value is a tool error the model
    can correct.

Security

  • promptguard mcp no longer takes an API key through the chat.
    promptguard_auth used to accept the key as a tool argument, which put it in
    the model's context, the client's transcript and any log of tool calls. The
    tool now only checks authentication and, when there is none, opens the
    dashboard and tells the user to save the key with promptguard login or
    PROMPTGUARD_API_KEY. A client still sending api_key is refused, and
    nothing is saved.
  • promptguard_redact no longer returns the un-redacted text. It passed the
    API's response through whole, including the original field, so the PII it
    removed came straight back into the conversation. It now returns redacted
    and piiFound only, as the hosted server does.

Changed

  • The MCP server follows the current spec. initialize negotiates the
    protocol version (2025-06-18, 2025-03-26 or 2024-11-05) instead of always
    answering 2025-03-26. It no longer advertises a logging capability it never
    implemented. Every tool has a title and behaviour annotations, and the scan,
    redact, scan-project and status tools declare an outputSchema and return
    structuredContent. Calling a tool that does not exist is now a JSON-RPC
    -32602 error rather than a tool result.
  • The shared MCP tools match the hosted server's exactly. scan_text,
    redact and status now carry the hosted server's title, description,
    parameters and annotations: scan_text and redact are read-only (each
    call is still one metered Request, which their descriptions now say), and
    tests/mcp-tool-definitions.json, a copy of the platform's published tool
    manifest, fails a test on any drift. Every tool's inputSchema sets
    additionalProperties: false, and an undeclared argument is now a tool error
    naming it instead of being ignored.
    Drop-in LLM security for your applications - Built with Rust + Tree-sitter

Installation

One-line install (macOS/Linux):

curl -fsSL https://raw.githubusercontent.com/promptguardhq/promptguard-cli/main/install.sh | sh

Manual install:

  1. Download the binary for your platform below
  2. Make it executable: chmod +x promptguard-*
  3. Move to PATH: sudo mv promptguard-* /usr/local/bin/promptguard
  4. Verify: promptguard --version

Checksums

SHA256 checksums are provided for each binary (.sha256 files).

About PromptGuard CLI

  • ✅ Real AST transformations using Tree-sitter
  • ✅ TypeScript, JavaScript, Python support
  • ✅ OpenAI, Anthropic, Cohere, HuggingFace providers
  • ✅ Automatic backups with safe revert
  • ✅ Single 5.3MB static binary

Supported Platforms

  • macOS ARM64 (M1/M2/M3)
  • macOS x86_64 (Intel)
  • Linux x86_64
  • Windows x86_64

📖 Documentation: https://docs.promptguard.co/cli
🏠 Homepage: https://promptguard.co
🐛 Issues: https://github.com/promptguardhq/promptguard-cli/issues

PromptGuard CLI v2.2.4

Choose a tag to compare

@github-actions github-actions released this 03 Nov 16:14

PromptGuard CLI v2.2.4

Added

  • Every release is announced in Slack #releases. The release workflow's
    new announce job posts the version and its GitHub Release once the
    release job has published it, through scripts/post-release.sh, a copy of
    the platform repo's script. It reads the SLACK_RELEASES_WEBHOOK_URL
    secret, and an unset secret or a Slack failure is a warning, never a failed
    release. The GitHub Release body was already this file's section.

Changed

  • The crate's author contact is now support@promptguard.co. hello@promptguard.co
    never existed, so mail to the address shown on crates.io bounced.
  • The crate's repository and the README's install commands point at
    github.com/promptguardhq/promptguard-cli, where the repository now lives.
  • Dependencies: serde_json 1.0.154, icu_normalizer 2.4.0, open 5.4.5 and
    aws-lc-rs 1.19.0 (#61).

Fixed

  • init and test no longer tell you to run promptguard logs, a command
    that does not exist. They now suggest promptguard verify, and a test fails
    if any message in the source names a subcommand the CLI does not have (#59).

Security

  • tokio 1.51.6 (RUSTSEC-2026-0386): 1.51.1's safe AsyncFd constructors
    let safe code violate I/O safety. The CLI never constructs an AsyncFd;
    the lockfile bump clears the advisory (#58).
    Drop-in LLM security for your applications - Built with Rust + Tree-sitter

Installation

One-line install (macOS/Linux):

curl -fsSL https://raw.githubusercontent.com/promptguardhq/promptguard-cli/main/install.sh | sh

Manual install:

  1. Download the binary for your platform below
  2. Make it executable: chmod +x promptguard-*
  3. Move to PATH: sudo mv promptguard-* /usr/local/bin/promptguard
  4. Verify: promptguard --version

Checksums

SHA256 checksums are provided for each binary (.sha256 files).

About PromptGuard CLI

  • ✅ Real AST transformations using Tree-sitter
  • ✅ TypeScript, JavaScript, Python support
  • ✅ OpenAI, Anthropic, Cohere, HuggingFace providers
  • ✅ Automatic backups with safe revert
  • ✅ Single 5.3MB static binary

Supported Platforms

  • macOS ARM64 (M1/M2/M3)
  • macOS x86_64 (Intel)
  • Linux x86_64
  • Windows x86_64

📖 Documentation: https://docs.promptguard.co/cli
🏠 Homepage: https://promptguard.co
🐛 Issues: https://github.com/promptguardhq/promptguard-cli/issues

PromptGuard CLI v2.2.3

Choose a tag to compare

@github-actions github-actions released this 23 Oct 16:31

PromptGuard CLI v2.2.3

Security

  • rustls-webpki 0.103.16 and webpki-root-certs 1.0.11, so certificate
    verification no longer accepts distrusted intermediates (RUSTSEC-2026-0382)
    and the bundled roots no longer trust the distrusted emSign intermediates
    (RUSTSEC-2026-0383).
    Drop-in LLM security for your applications - Built with Rust + Tree-sitter

Installation

One-line install (macOS/Linux):

curl -fsSL https://raw.githubusercontent.com/acebot712/promptguard-cli/main/install.sh | sh

Manual install:

  1. Download the binary for your platform below
  2. Make it executable: chmod +x promptguard-*
  3. Move to PATH: sudo mv promptguard-* /usr/local/bin/promptguard
  4. Verify: promptguard --version

Checksums

SHA256 checksums are provided for each binary (.sha256 files).

About PromptGuard CLI

  • ✅ Real AST transformations using Tree-sitter
  • ✅ TypeScript, JavaScript, Python support
  • ✅ OpenAI, Anthropic, Cohere, HuggingFace providers
  • ✅ Automatic backups with safe revert
  • ✅ Single 5.3MB static binary

Supported Platforms

  • macOS ARM64 (M1/M2/M3)
  • macOS x86_64 (Intel)
  • Linux x86_64
  • Windows x86_64

📖 Documentation: https://docs.promptguard.co/cli
🏠 Homepage: https://promptguard.co
🐛 Issues: https://github.com/acebot712/promptguard-cli/issues