Skip to content

Security: maci0/muninn-sidecar

Security

SECURITY.md

Security Policy

Reporting a vulnerability

Please report security issues privately — do not open a public issue.

Use GitHub's private vulnerability reporting: the repository's Security tab → Report a vulnerability. Include a description, affected version/commit, and a reproduction if possible. You'll get an acknowledgement and a fix or mitigation plan; please allow reasonable time before any public disclosure.

Supported versions

Fixes target the latest released version and main. Pin a released tag for stability and update when security fixes land.

Security model & sensitive surfaces

msc is a local proxy between a coding agent and its LLM API. A few areas warrant care:

  • TLS-MITM (--mitm, opt-in, off by default). When enabled, msc generates a local certificate authority (key stored 0600 under the user config dir, never leaving the machine) and mints per-host leaf certs to decrypt the agent's HTTPS. Trust is scoped to the launched child via env vars (NODE_EXTRA_CA_CERTS / SSL_CERT_FILE / …) — msc never installs the CA into the system trust store. Only the upstream host is terminated by default; other hosts are blind-tunneled (--mitm-host to scope explicitly).
  • Captured content & secrets. Exchanges are stored in MuninnDB. msc redacts well-known credential formats before storage and before injecting recalled content, but redaction is best-effort (conservative patterns) — not a guarantee. Treat the vault as sensitive. --no-redact disables write-side redaction for trusted local environments.
  • Tokens & transport. The MuninnDB bearer token is read from ~/.muninn/mcp.token (msc warns on overly-permissive perms or plaintext HTTP to a non-loopback endpoint). The proxy listens on loopback (127.0.0.1).

The build has no third-party dependencies (standard library only); make vuln (govulncheck) and CI scan the reachable code against the Go vulnerability DB.

See ARCHITECTURE.md and the README for the full design.

There aren't any published security advisories