Wire transparency — every outbound call, byte for byte

Published: July 19, 2026 · Updated: October 25, 2026

Outbound connections from the apps are limited to the documented OpenHeaders endpoints below, plus targets the operator configures themselves (IdP issuer for SSO, Git remotes, an audit/SIEM collector, and whatever requests the user’s own rules and workflows make). This document is the published specification of every phone-home payload; if a request is not listed here, the app does not make it. The app is fully functional with all of these unreachable or disabled — see the per-endpoint off switches.

The only data that ever leaves is the two anonymous telemetry channels of section 5: a typed allowlist of feature-usage counts, and crash and error reports that carry the kind of failure and its position in our own code — never the message. Both are structurally incapable of carrying URLs, headers, traffic, or identity, default-on for the desktop app, extension, and CLI with a one-switch opt-out each, and hard-off for the daemon, the served web app, and the MCP server. The license system itself remains telemetry-free: license endpoints and telemetry never share identifiers, payloads, or deployments.

The browser extension’s only OpenHeaders-bound calls are those two telemetry channels (section 5) and the on-demand release-notes history fetch (section 4); browser store distribution owns its updates.

1. License refresh

Self-serve subscription renewal. Node hosts only (desktop main process and the daemon — never the extension). The agent only ever delivers files: the response is verified offline against the compiled-in Ed25519 trust ring before anything persists; no online validation path exists.

{
  "licenseKey": "oh-license.<base64url payload>.<base64url signature>",
  "appVersion": "2026.7.10",
  "platform": "darwin"
}

2. Update check

Anonymous check, staging by default, and a restart that is never unprompted: an available update may download in the background (default on, one switch to off), but a running app is only ever restarted by an explicit “Update & Restart” click or a quit that happens anyway. The oh CLI additionally self-updates between invocations on self-managed binary installs (default on, oh autoupdate off to stop) — it swaps its own binary so the next run launches the new version, restarting nothing. Who checks: desktop packaged builds on macOS/Windows and Linux AppImage, the oh CLI (daily cached), and the ohd daemon only when you run ohd status or opt into its default-off unattended mode. Dev builds, deb/rpm installs, container images, and npm/brew installs make no update requests — their owning channel updates them.

3. Severity manifest

A small static severity manifest published to the update feed on each release — { latest, tag, severity, minimumSafeVersion } per app — so a security release can escalate loudly (red badge, entry banner). Severity is authored by a human before each release, never derived from anything about your install.

4. Release notes history

Each app ships its own current release notes inside the build — the What’s New screen renders them with zero network. The only wire traffic is the optional history underneath: the desktop app and the extension can list previous releases from the public changelog feed and fetch an older entry’s notes when you expand it. The CLI’s oh changelog is fully air-gapped, and the server daemon serves its own bundled notes to its admin console — the browser never dials the feed.

5. Anonymous telemetry

Two channels, one worker, one switch each. Anonymous usage counting — which features get used. The event vocabulary is a typed allowlist compiled into the app: every payload property is a closed union, boolean, or number; free-form strings are banned by a guard test, so URLs, hostnames, header names or values, rule contents, request/response data, and file paths are inexpressible. Crash and error reports (2026-10, the second channel, documented after the usage channel below) — what kind of failure happened and where in our own code, never the message. The in-app inspector (Settings → Application → About → Privacy → “View events” / “View reports”) shows every event and every report of the current session byte for byte, sent or suppressed.

{
  "schemaVersion": 3,
  "host": "extension",
  "channel": "chrome-store",
  "appVersion": { "year": 2026, "month": 10, "patch": 3 },
  "platform": "mac",
  "arch": "arm64",
  "browser": "firefox",
  "locale": "en",
  "osVersion": 15,
  "browserVersion": 131,
  "sessionId": "c0ffee00c0ffee00c0ffee00c0ffee00",
  "installId": "feedface00feedface00feedface0000",
  "sinceInstall": "2-7",
  "sessionAge": "1-8h",
  "sentAt": 1760000000000,
  "state": {
    "stage": "activated",
    "rules": "2-5",
    "requests": "1",
    "workspaces": "1",
    "sync": "local",
    "role": "none",
    "team": "1",
    "profile": "both",
    "activeDays": "4-9",
    "migratedFrom": "postman"
  },
  "events": [
    { "name": "first_run" },
    { "name": "session_start" },
    { "name": "milestone", "kind": "first_rule_created" },
    { "name": "feature_used", "feature": "workflow-editor" },
    { "name": "rule_created", "ruleType": "header", "origin": "editor" },
    { "name": "rule_matched", "ruleType": "header" },
    { "name": "request_sent", "protocol": "http" },
    { "name": "import_run", "source": "postman", "ok": true },
    { "name": "workflow_run", "ok": true },
    { "name": "share_sent", "route": "server-admin", "role": "editor", "members": "2-5" },
    { "name": "share_accepted", "route": "server", "role": "editor" },
    { "name": "error_beacon", "code": "ws-connect-failed" },
    { "name": "license_activated", "plan": "individual" },
    { "name": "limit_hit", "limit": "seats" },
    { "name": "upgrade_cta_shown", "surface": "license-pane" },
    { "name": "upgrade_cta_clicked", "surface": "grace-banner" },
    { "name": "mcp_client_connected", "client": "claude-code" },
    { "name": "viewport_seen", "surface": "workbench", "width": 1280, "height": 800 }
  ]
}

What the warehouse keeps, column by column

One row per event. From names the wire field in this document’s words — envelope.* the batch fields above, event.* the event’s own, edge.* the two values the worker adds, row.* the archive object’s identity (its key and the event’s position in it), web.* the landing-page records; Rows names the events that declare a column, which is empty on every other row. Generated from the warehouse’s column registry — the table and the schema are one definition.

ColumnTypeFromRows
object_keytextrow.objectKeyevery row
line_indexintegerrow.lineIndexevery row
provenancetextrow.provenanceevery row
sample_intervalintegerrow.sampleIntervalevery row
received_attimestamptzedge.receivedAtevery row
daydateedge.receivedAt (UTC day)every row
nametextevent.nameevery row
schema_versionintegerenvelope.schemaVersionevery row
hosttextenvelope.hostevery row
channeltextenvelope.channelevery row
platformtextenvelope.platformevery row
browsertextenvelope.browserevery row
localetextenvelope.localeevery row
countrytextedge.countryevery row
version_yearintegerenvelope.appVersion.yearevery row
version_monthintegerenvelope.appVersion.monthevery row
version_patchintegerenvelope.appVersion.patchevery row
version_betaintegerenvelope.appVersion.betaevery row
app_versiontextenvelope.appVersion (CalVer label)every row
archtextenvelope.archevery row
os_versionintegerenvelope.osVersionevery row
browser_versionintegerenvelope.browserVersionevery row
install_idtextenvelope.installIdevery row
session_idtextenvelope.sessionIdevery row
since_installtextenvelope.sinceInstallevery row
session_agetextenvelope.sessionAgeevery row
stagetextenvelope.state.stageevery row
rulestextenvelope.state.rules (schema 2: session_start.rules)every row
requeststextenvelope.state.requestsevery row
workspacestextenvelope.state.workspaces (schema 2: session_start.workspaces)every row
synctextenvelope.state.sync (schema 2: session_start.sync)every row
plantextenvelope.state.planevery row
roletextenvelope.state.roleevery row
teamtextenvelope.state.teamevery row
profiletextenvelope.state.profileevery row
active_daystextenvelope.state.activeDaysevery row
migrated_fromtextenvelope.state.migratedFromevery row
milestonetextevent.kindmilestone
rule_typetextevent.ruleTyperule_created, rule_matched
origintextevent.originrule_created
protocoltextevent.protocolrequest_sent
import_sourcetextevent.sourceimport_run
okbooleanevent.okimport_run, workflow_run
routetextevent.routeshare_sent, share_accepted
share_roletextevent.roleshare_sent, share_accepted
share_memberstextevent.membersshare_sent
tooltextevent.tool (schema 2: feature_used.feature)tool_used
surfacetextevent.surfacesurface_opened
widthintegerevent.width (floor)surface_opened
heightintegerevent.height (floor)surface_opened
cta_idtextevent.idcta
cta_actiontextevent.actioncta
spottextevent.spot (schema 2: the monetization surface)cta, limit_hit
limit_kindtextevent.limitlimit_hit
license_plantextevent.planlicense_activated
mcp_clienttextevent.clientmcp_client_connected
peertextevent.peerpeer_connected
help_topictextevent.topichelp_opened
codetextevent.codeerror_beacon
reasontextweb.reasonuninstall_reason
sent_attimestamptzenvelope.sentAtevery row

Crash and error reports (2026-10)

When the app crashes or hits an error it did not expect — a render error a containment boundary caught, an uncaught exception, an unhandled promise rejection, a renderer or GPU process gone, a window that stopped responding, a previous run that never reached a clean quit — it reports what kind of failure it was and where in the app’s own code it happened. The message never travels: a report carries the error’s class name and the template its message matched, the positions of the frames in Open Headers’ own bundles, and the React component names on the path. Every string on this channel is admitted only under a pinned grammar that cannot express a URL, a path, a header, whitespace, or a quote (the grammar table below); a guard test asserts every string field carries its pin.

{
  "schemaVersion": 1,
  "host": "desktop",
  "channel": "github-release",
  "appVersion": { "year": 2026, "month": 10, "patch": 2 },
  "platform": "mac",
  "arch": "arm64",
  "locale": "en",
  "osVersion": 15,
  "sessionId": "c0ffee00c0ffee00c0ffee00c0ffee00",
  "sessionAge": "10-59m",
  "sentAt": 1760000000000,
  "reports": [
    {
      "kind": "render-error",
      "process": "renderer",
      "surface": "request-edit",
      "errorName": "TypeError",
      "template": "cannot-read-property",
      "frames": [
        { "file": "index-abc123.js", "line": 1, "col": 48213, "fn": "renderRows" },
        { "external": true }
      ],
      "componentStack": ["RequestEditor", "WorkbenchTabBody"],
      "fingerprint": "0123456789abcdef",
      "count": 1
    },
    { "kind": "renderer-gone", "process": "renderer", "reason": "oom", "exitCode": 5, "reopenCount": 0,
      "frames": [], "fingerprint": "89abcdef01234567", "count": 1 },
    { "kind": "abnormal-exit", "process": "main", "frames": [], "fingerprint": "fedcba9876543210", "count": 1 }
  ]
}

Everything else

Anything else leaving the process is operator-configured, not OpenHeaders-bound: the OIDC issuer you set, the Git remotes you sync, the SIEM collector you point audit streaming at, and the HTTP requests your own rules, sources, and workflows define.