Privacy and usage statistics

Plonix keeps your work on your computer. Captured traffic, projects, findings, scope and settings are stored only in folders on your disk (~/.plonix and your project folders). Plonix never uploads them.

The one thing Plonix can send on its own is a small, anonymous usage report, if you allow it. This page lists exactly what that report holds.

Your choice#

  • Statistics are off unless you turn them on. On first launch, Plonix first shows its license and terms of use, then asks once on a card of its own, Help shape Plonix?: it lists what a report holds and what is never sent, shows an example report built on your computer (nothing is counted or kept to make it), and shows the live public totals from plonix.io/analytics. Nothing is counted until you pick Share Anonymous Stats or No Thanks; if you close Plonix first, it asks again next time. The CLI asks the same question the first time it runs in a terminal, and "no" is the default.
  • To show the live totals, that card reads https://plonix.io/api/stats, the same public numbers the page shows. Nothing about your install goes with that request, and it is the only time Plonix reads it.
  • Change it any time: Settings › Usage statistics in the app, or plonix usage on / plonix usage off.
  • Settings › Usage statistics › Show What Is Sent and plonix usage show the next report exactly as it would be sent.
  • Reset Install ID (or plonix usage reset) deletes everything kept so far; the next count starts with a new random id.
  • Setting PLONIX_NO_ANALYTICS=1 or DO_NOT_TRACK=1 in the environment turns it off whatever the setting says.
  • Turning it off deletes the counts and the install id kept so far (~/.plonix/usage.json).

Accepting the terms for a single run (--accept-terms or PLONIX_ACCEPT_TERMS=1, meant for scripts and CI) records nothing, so a Plonix home used only that way never counts anything. Nothing is sent from CI (CI is set) or from development builds.

What a report holds#

At most one report a day, sent by HTTPS POST to https://plonix.io/api/usage:

{
  "schema": 2,
  "install_id": "3f9c2a6e0b7d4e1f8a5c6b2d9e0f1a7c",
  "version": "0.2.0",
  "os": "macos",
  "os_version": "15.1",
  "arch": "aarch64",
  "counts": { "app_launched": 4, "project_opened": 3, "screen_bench": 9, "bench_send": 27, "scan_run": 1 },
  "minutes": { "traffic": 41, "bench": 18, "scope": 3 },
  "filters": { "host": 6, "-host": 2, "status": 3, "text": 4 },
  "profile": "bug-hunter",
  "look": { "style": "studio", "theme": "auto", "density": "dense" },
  "projects": "2-5",
  "sizes": {
    "requests": { "1k-10k": 1, "101-1k": 1 },
    "hosts": { "21-100": 1, "6-20": 1 },
    "in_scope": { "1": 1, "2-5": 1 }
  },
  "rejected": { "google-analytics.com": 2, "sentry.io": 1, "other": 2 }
}
FieldWhat it is
schemaThe version of this report's shape.
install_id32 random hex characters made the first time a count is saved. Not derived from your hardware, account or anything else. Deleted when you turn statistics off or reset it.
versionThe Plonix version.
os, os_versionThe operating system and its release, major and minor only, such as macos and 15.1.
archThe CPU type, such as aarch64 or x86_64.
countsHow many times each feature below was used since the last report.
minutesActive minutes per screen of the project window since the last report. A minute counts only while the window has focus and was used (a click, a key, scrolling) in the last two minutes, and at most one minute counts per minute however many windows are open. Screen names come from a fixed list: traffic, bench, scope, map, users, access, callbacks, findings, agents, market, scans, programs, rules, settings.
filtersHow many Traffic searches used each kind of term: host, method, status, path, mime, scope, source, ext, kind, is or text (anything else), with - in front for a term that hides. Only the kind: host:shop.example counts as host, and what you typed is never kept. The same search refreshing counts once.
profileThe kind of work picked on first launch: bug-hunter, red-teamer, researcher, or none.
lookThe window style, theme and spacing picked in Settings › Appearance.
projectsHow many projects Plonix knows about, as a range.
sizesFor each project opened since the last report: how many requests it holds, how many distinct hosts it has seen, and how many of those are in scope, each as a range. The numbers are how many projects fell in each range.
rejectedFor each project opened since the last report, the out-of-scope hosts that belong to a fixed list of well-known third-party services (the domains in Plonix's built-in exclusion groups, such as google-analytics.com, doubleclick.net or sentry.io, and its list of browser noise). Any other rejected host is counted as other and its name never leaves your computer. The numbers are how many projects rejected each one.

Ranges are always one of 0, 1, 2-5, 6-20, 21-100, 101-1k, 1k-10k, 10k-100k or 100k+. Exact numbers are never sent.

The counted features are a fixed list:

NameCounted when
app_launchedPlonix.app starts
web_launcher_openedplonix launcher opens the Start screen in a browser
cli_usedA plonix command runs
project_opened, demo_openedA project, or the demo project, opens
capture_startedThe capture browser opens
intercept_usedIntercept is turned on
bench_sendThe Bench (or plonix replay) sends a request
bench_runThe Bench runs payloads through marked positions
access_checkAn access check runs a request as each saved user
scan_run, crawl_runA scan or a crawl runs
program_appliedA project starts following a bug bounty or disclosure program
callbacks_startCallbacks (out-of-band checks) start listening
finding_added, report_exportedA finding is added, findings are exported
market_installSomething is installed from the Market
ask_claude, agent_launchAsk Claude is used, Claude Code is opened from Plonix
mcp_sessionAn AI agent starts the Plonix MCP server
screen_traffic, screen_bench, screen_scope, screen_map, screen_users, screen_access, screen_callbacks, screen_findings, screen_agents, screen_market, screen_scans, screen_programs, screen_rules, screen_settingsA screen of the project window is opened

What is never sent#

  • URLs, hosts, domains, paths or IP addresses from captured traffic
  • Requests, responses, headers, bodies or any other traffic
  • Project names, folder or file paths, scope, findings, rules or settings
  • Anything you type: searches, payloads, prompts, notes
  • Your name, email, user name, computer name or hardware identifiers

The one-time "Star Plonix on GitHub" card is counted separately and only on your computer: star.json in the Plonix folder keeps how many days you used Plonix and whether you answered the card. It is never sent, whether usage statistics are on or off.

On the server#

The endpoint is a small function on the Plonix website (functions/api/usage.js in this repository). It accepts only the fields above and treats every one of them as untrusted: names must come from the fixed lists above (any other feature, screen, kind, range or domain is dropped), the version must look like 1.2.3, the OS and CPU type must be known ones (anything else is stored as other), the OS release keeps digits only, and every number is a capped whole number. Nothing is stored as free text, and stores one row per install per day: the date, the fields above, and nothing else. It never reads or stores your IP address or request headers, the User-Agent included. A failed send is silent: Plonix never waits on it or retries more than once a day.

The public totals#

plonix.io/analytics shows totals over the last 30 days, built by functions/api/stats.js: downloads (from the GitHub release files), active and new installs, hours of use, which features and screens are used, kinds of work, versions, systems, project size ranges, the most rejected well-known domains, and the most used kinds of filter. No group of fewer than five installs is ever shown: it is folded into "other", or left out. Single reports and install ids are never published.

The website#

The Plonix website, plonix.io, counts page views with Cloudflare Web Analytics, which its host adds to every page. Cloudflare says this sets no cookies and does not track you across sites. The website has no other trackers and no ads. The public totals above come only from Plonix itself, never from the website.

This page is docs/privacy.md in the Plonix repository. Spotted something wrong? Suggest a change.