MCP, MCP server
io.github.anthonysuherli/br8n
A self-maintaining, portable personal knowledge base.
Compatibility: Not stated.
Grade D
Two or more Medium findings, or a High finding. Only try it in a sandbox.
Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.
AGENT_HIDDEN_STEP
Why this grade
- AGENT_HIDDEN_STEP High
Text tells the agent to hide a step or not to tell the user.
skills/embeddings/SKILL.md, line 87
Do not tell the user local embeddings match the remote model's quality. They
Any High, or two or more Medium findings, give D. One Medium gives C. Low findings or a security Note give B. Each code names a finding behind the letter.
If you think this grade is wrong, email [email protected] with the entry link and your evidence. We aim to acknowledge within two working days and decide within seven. If we confirm an error, we aim to correct it within 24 hours of confirming it. These are aims, not guarantees.
Grades are a hygiene check of the source at the commit shown, on the date checked, not a security audit or a guarantee. The free directory grades are automated. Before release, a PlugVet engineer reviews every paid report and any grade we hold back, including all F grades, against the source code and the evidence we quote.
What was checked
Plain notes from the hygiene checks.
Permissions
Note
requests shell access. The manifest names this permission.
PERMISSION_SHELL_DECLARED
backend/br8n/livingdocs/drift.py, line 62
res = subprocess.run(
backend/br8n/livingdocs/watch.py, line 50
res = subprocess.run(
hooks/auto-capture.py, line 68
res = subprocess.run(
Show more
hooks/auto-capture.py, line 94
res = subprocess.run(
hooks/first-run-init.py, line 65
result = subprocess.run(
hooks/first-run-init.py, line 80
result = subprocess.run(
hooks/first-run-init.py, line 122
result = subprocess.run(
hooks/preamble-inject.py, line 36
top = subprocess.run(
Install and update
Pass
No install-time script found, and dependencies are pinned or absent.
Network
Concern
can reach a host that is not written as a fixed address.
NETWORK_NO_FIXED_HOST
scripts/br8n-statusline.py, line 416
with urllib.request.urlopen(req, timeout=CLOUD_TIMEOUT) as resp:
scripts/br8n-statusline.py, line 508
with urllib.request.urlopen(req, timeout=CLOUD_TIMEOUT) as resp:
scripts/br8n-statusline.py, line 558
maps[project] = fetch(project)
Show more
scripts/br8n-statusline.py, line 617
branch_map = fetch(cur_project)
docs/plans/2026-05-30-statusline-resume-cue-impl.md, line 691
branch_map = fetch(cur_project)
docs/plans/2026-05-30-statusline-resume-cue-impl.md, line 798
with urllib.request.urlopen(req, timeout=CLOUD_TIMEOUT) as resp:
Secrets
Concern
reads a credential or environment file.
SECRETS_ENV_READ SECRETS_PATH_DOTENV
CLAUDE.md, line 167
cp .env.example .env # pick the FREE or PAID block (see file)
backend/br8n/config.py, line 4
* ``Settings`` - secrets and infra (API keys, Supabase, CORS). From env / .env.
backend/br8n/config.py, line 24
env_file=Path(__file__).resolve().parents[1] / ".env", extra="ignore"
Show more
backend/br8n/settings_file.py, line 5
* ``Settings`` (env/.env) - secrets and infra, set by whoever deploys.
backend/br8n/api/auth.py, line 36
key = os.getenv("BR8N_API_KEY", "")
backend/br8n/api/auth.py, line 38
raise RuntimeError("BR8N_API_KEY is not set - set it in your .env file")
scripts/br8n-statusline.py, line 298
# ── .env / tier resolution ──────────────────────────────────────────────────
scripts/br8n-statusline.py, line 300
"""Parse backend/.env (best-effort) for Supabase creds."""
scripts/br8n-statusline.py, line 303
os.path.join(root, "backend", ".env"),
Agent instructions
Serious
instructions tell the agent to hide a step.
AGENT_HIDDEN_STEP
skills/embeddings/SKILL.md, line 87
Do not tell the user local embeddings match the remote model's quality. They
Obfuscation
Pass
No encoded or minified payload found.
Licence
Pass
A licence file is present (LICENSE).
Maintainer activity
Pass
The latest commit is within the last 365 days.
Note
Hygiene check of commit a764619a6e2d. requests shell access. The manifest names this permission. can reach a host that is not written as a fixed address. reads a credential or environment file. instructions tell the agent to hide a step.
Date and source
Date checked:
github.com
Commit graded: a764619a6e2d0a1c0f78067da41a5f42f6bf7fd6
This link goes to the original host. PlugVet does not host or check what you download from there, and installing it is your own decision and risk.