Security
Security and Reporting
Report Wenlan vulnerabilities privately, redact diagnostic output, and understand the local daemon security boundary.
At a glance
01
Quick answer: use GitHub Issues for normal bugs, but report vulnerabilities through the private advisory or email path.
02
Redact private memory contents, API keys, client names, daemon databases, and ~/.wenlan archives before sharing diagnostics.
01
Quick answer: where to report
Normal setup bugs, docs issues, and feature requests belong in GitHub Issues with redacted diagnostic output.
If you discover a vulnerability, do not open a public issue. Use the private GitHub Security Advisory path or the email address in SECURITY.md with the description, reproduction steps, affected version, and potential impact.
- Public bugs: include client, OS, command, expected behavior, actual behavior, and redacted /setup, doctor, or wenlan status output.
- Security reports: include impact, reproduction steps, affected version or commit, and only the minimum redacted data needed to reproduce.
- Never attach ~/.wenlan, the daemon database, private captures, API keys, or unredacted project logs to a public issue.
02
Local-first boundary
Wenlan keeps its working data local by default: daemon, database, Markdown artifacts, sessions, and git history live on your machine.
That does not make every connected workflow offline. Your AI client may send prompts to its own provider, and Wenlan can optionally use configured model or API paths for daemon-side language work.
03
Secrets and memory contents
Treat memory as sensitive application data. It can contain project decisions, personal preferences, private codebase details, client names, and old versions preserved by local git history.
If a bug involves a sensitive memory, create a minimal reproduction with fake content instead of sharing the real record.
04
Network exposure
The daemon binds to 127.0.0.1:7878 by default. That keeps the HTTP API local to the machine for normal use.
Changing WENLAN_BIND_ADDR to a non-loopback address is an explicit security decision. Do it only for deliberate Docker, VM, or development scenarios where you understand who can reach the daemon.
05
Security policy
The public website publishes /.well-known/security.txt for automated discovery. The source repository also carries the canonical security policy, including best-effort acknowledgment within 72 hours, hot-fix handling for critical issues, and the current stable 0.15.8 line.
If in doubt, choose the private advisory or email path first. A maintainer can move non-sensitive follow-up work into a public issue later.
Next
Evaluation
What Wenlan's published retrieval numbers mean, how they are generated, and what they do not claim.
Read next