Repository navigation
Releases
PromptGuard CLI v2.6.0
PromptGuard CLI v2.6.0
Added
scan --jsonand the MCPpromptguard_scan_projecttool report
has_api_key_headerfor each SDK instance: whether the call sets the
X-API-Keyheader, 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 isnullwhen the headers
come from a variable, a splat or a spread the scan cannot see.
has_base_urlalone 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 | shManual install:
- Download the binary for your platform below
- Make it executable:
chmod +x promptguard-* - Move to PATH:
sudo mv promptguard-* /usr/local/bin/promptguard - 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
PromptGuard CLI v2.5.2
Fixed
- Clients rewritten by
initandapplynow authenticate to the proxy.
The rewrite added the proxy base URL but never theX-API-Keyheader, the
only place the proxy reads your PromptGuard key from, so every rewritten
client got401 missing_api_key. It now addsdefault_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 runinitorapplyagain. 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
initandapplynow reach the proxy.
The rewrite used the/api/v1proxy URL, but the Anthropic SDK appends
/v1itself, so requests went to/api/v1/v1/messages; and the SDK sends
its key inX-Api-Key, the header the proxy reads your PromptGuard key
from. The rewrite now uses the proxy URL without/v1, sends your
PromptGuard key asX-API-Key, and moves your Anthropic key out of
api_key/apiKeyintoAuthorization: Bearer, which the proxy forwards
to Anthropic. A client an earlier version rewrote is repaired when you run
initorapplyagain. Calls that setauth_token,credentials,
profileor headers of their own are listed for manual routing (#66). A
client that took its credential fromANTHROPIC_AUTH_TOKEN, a profile or
workload identity in the environment now sendsANTHROPIC_API_KEYinstead:
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 | shManual install:
- Download the binary for your platform below
- Make it executable:
chmod +x promptguard-* - Move to PATH:
sudo mv promptguard-* /usr/local/bin/promptguard - 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
PromptGuard CLI v2.5.1
Fixed
promptguard verifyno longer fails against a healthy API. Its
connectivity check asked for/api/v1/health, which the API does not serve
(/healthis at the host root), soverifyreportedAPI unreachable
with a working key and exited2, andwhoamiandtestsaid the API was
unreachable. CI jobs gated onverify --json, as the docs' GitHub Actions
example is, failed on every run. The check now probes/healthat the host
root of your base URL; a base URL that does not end in/api/v1is 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 | shManual install:
- Download the binary for your platform below
- Make it executable:
chmod +x promptguard-* - Move to PATH:
sudo mv promptguard-* /usr/local/bin/promptguard - 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
PromptGuard CLI v2.5.0
Added
-
The local MCP server's
promptguard_redacttakespii_types, as the
hosted tool does. Name the PII types to redact in the REST API's
vocabulary (detector names such asemailorphone_us, the aliases
phone,ip_addressandpassport, andapi_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_redactresults carryskipped. 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-udpto 0.5.16 (RUSTSEC-2026-0538) andrustix
to 1.1.6 (RUSTSEC-2026-0486). Neither was in the shipped binary:
quinn-udpbelongs to the HTTP client's HTTP/3 support, which the CLI does
not enable, andrustixonly to the test suite. The update keeps
cargo auditclean.
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 | shManual install:
- Download the binary for your platform below
- Make it executable:
chmod +x promptguard-* - Move to PATH:
sudo mv promptguard-* /usr/local/bin/promptguard - 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
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.jsonnow lists the hosted server's Read-stage
tools andpromptguard_propose_suppression.scripts/check_mcp_tool_manifest.py
failsmake ciand the pre-push hook when the copy is not byte-identical to
the platform'sorigin/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 | shManual install:
- Download the binary for your platform below
- Make it executable:
chmod +x promptguard-* - Move to PATH:
sudo mv promptguard-* /usr/local/bin/promptguard - 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
PromptGuard CLI v2.4.0
Added
promptguard mcp installadds 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: throughclaude mcp addandcodex mcp addfor the first two, by
merging onepromptguardentry 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.--clientslimits it to named clients,--dry-run
shows what would change,--localinstalls the local stdio server instead
and--urlpoints 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 | shManual install:
- Download the binary for your platform below
- Make it executable:
chmod +x promptguard-* - Move to PATH:
sudo mv promptguard-* /usr/local/bin/promptguard - 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
PromptGuard CLI v2.3.1
Fixed
- Links to the dashboard's API keys page work again.
promptguard key,
init,login,test, the MCP server'spromptguard_authand
install.shsent you tohttps://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 linkhttps://app.promptguard.co/dashboard/api-keys, and
init's sign-up link goes to/registerinstead 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 | shManual install:
- Download the binary for your platform below
- Make it executable:
chmod +x promptguard-* - Move to PATH:
sudo mv promptguard-* /usr/local/bin/promptguard - 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
PromptGuard CLI v2.3.0
Added
promptguard mcpspeaks MCP 2026-07-28 and 2025-11-25. A 2026-07-28
client needs noinitialize: each request names its revision in_meta,
server/discoveranswers 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, fortools/listand
server/discover,ttlMsandcacheScope;pingandlogging/setLevel,
which 2026-07-28 removed, are unknown methods there. Older clients still
open withinitialize, which now also agrees on 2025-11-25.promptguard_scan_texttakescontent_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 scantype; any other value is a tool error the model
can correct.
Security
promptguard mcpno longer takes an API key through the chat.
promptguard_authused 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 withpromptguard loginor
PROMPTGUARD_API_KEY. A client still sendingapi_keyis refused, and
nothing is saved.promptguard_redactno longer returns the un-redacted text. It passed the
API's response through whole, including theoriginalfield, so the PII it
removed came straight back into the conversation. It now returnsredacted
andpiiFoundonly, as the hosted server does.
Changed
- The MCP server follows the current spec.
initializenegotiates the
protocol version (2025-06-18, 2025-03-26 or 2024-11-05) instead of always
answering 2025-03-26. It no longer advertises aloggingcapability it never
implemented. Every tool has atitleand behaviour annotations, and the scan,
redact, scan-project and status tools declare anoutputSchemaand return
structuredContent. Calling a tool that does not exist is now a JSON-RPC
-32602error rather than a tool result. - The shared MCP tools match the hosted server's exactly.
scan_text,
redactandstatusnow carry the hosted server's title, description,
parameters and annotations:scan_textandredactare 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'sinputSchemasets
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 | shManual install:
- Download the binary for your platform below
- Make it executable:
chmod +x promptguard-* - Move to PATH:
sudo mv promptguard-* /usr/local/bin/promptguard - 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
PromptGuard CLI v2.2.4
Added
- Every release is announced in Slack
#releases. The release workflow's
newannouncejob posts the version and its GitHub Release once the
release job has published it, throughscripts/post-release.sh, a copy of
the platform repo's script. It reads theSLACK_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
repositoryand the README's install commands point at
github.com/promptguardhq/promptguard-cli, where the repository now lives. - Dependencies:
serde_json1.0.154,icu_normalizer2.4.0,open5.4.5 and
aws-lc-rs1.19.0 (#61).
Fixed
initandtestno longer tell you to runpromptguard logs, a command
that does not exist. They now suggestpromptguard 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
AsyncFdconstructors
let safe code violate I/O safety. The CLI never constructs anAsyncFd;
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 | shManual install:
- Download the binary for your platform below
- Make it executable:
chmod +x promptguard-* - Move to PATH:
sudo mv promptguard-* /usr/local/bin/promptguard - 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
PromptGuard CLI v2.2.3
Security
rustls-webpki0.103.16 andwebpki-root-certs1.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 | shManual install:
- Download the binary for your platform below
- Make it executable:
chmod +x promptguard-* - Move to PATH:
sudo mv promptguard-* /usr/local/bin/promptguard - 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