Skip to content

Security: canblmz1/promptfix

Security

SECURITY.md

Security Policy

Local-First Security Model

PromptFix is a local-only tool. The HTTP service (promptfix service) binds exclusively to 127.0.0.1 and is not reachable from other devices or the internet.

What PromptFix does

Component Where it runs Network access
CLI (promptfix once, promptfix doctor) Local process Only to configured provider API
Local service (promptfix service) 127.0.0.1:52849 Only to configured provider API
Browser extension Chrome, MV3 Only to 127.0.0.1:52849
Disk cache (~/.promptfix/cache/) Local filesystem None
History log (~/.promptfix/history.jsonl) Local filesystem None

Data Handling

  • Prompts are sent to your configured AI provider (Groq, OpenAI-compatible, or Ollama).
    If you use Ollama, no data leaves your machine.
  • History and cache are stored only on your local disk under ~/.promptfix/.
  • No telemetry, analytics, or crash reporting is collected.

Known Limitations

  • The service token (config.yaml → service.token) is optional but recommended when the browser extension is in use. Without it, any process on your machine can call the service.
  • The extension manifest currently uses http://127.0.0.1:*/* as a host permission (wildcard port). A future release will pin this to port 52849.
  • <all_urls> content script permission is used for context extraction. A future release will remove this when the context feature is made opt-in.

Dependency Supply-Chain

All dependencies are pinned in pyproject.toml. Run pip-audit to check for known CVEs:

pip install pip-audit
pip-audit

Supported Versions

Version Supported
1.x ✅ Yes
< 1.0 ❌ No

Reporting a Vulnerability

Please do not open a public GitHub issue for security vulnerabilities.

Instead, email the maintainer directly (see pyproject.toml for contact) or use GitHub private vulnerability reporting.

Expect an acknowledgement within 72 hours. We aim to release a patch within 14 days for critical issues.

There aren't any published security advisories