Telemetry policy
Telemetry in Forge is opt-in. Default is off. You enable or disable it from Settings → Advanced → Telemetry.
What “opt-in” means here
Section titled “What “opt-in” means here”You ship Forge without telemetry. Period. Until you toggle the setting on, no telemetry events leave your machine, regardless of what’s happening in the app.
When you toggle it on, Forge generates an anonymous install ID (a random UUID, scoped to this install) and starts sending events. Toggling off stops new events immediately.
What gets sent
Section titled “What gets sent”The set is intentionally narrow:
- Install ID: anonymous UUID generated on opt-in, stored in
%APPDATA%\Forge\telemetry.json. Not tied to your name, email, or Ranga account. - App version:
0.7.3-style semver string. - OS version: Windows 10 / 11 / build number.
- Error stack traces: when Forge or the Codex sidecar throws an unhandled exception, the stack lands in telemetry so we can fix the bug.
What never gets sent
Section titled “What never gets sent”- Chat messages or any prompt content.
- File contents or paths inside your project.
- Project names or
.forge/memory file content. - API keys or OAuth tokens.
- Generated asset content or prompts.
- Anything that could identify you personally.
Where it goes
Section titled “Where it goes”The current backend is Posthog (or a self-hosted equivalent if/when we move). Telemetry events transit over HTTPS. We don’t have a third-party analytics vendor outside of the telemetry backend.
Revoking
Section titled “Revoking”Toggle the Telemetry setting off in Settings → Advanced. Stops new events immediately.
Existing events expire from the backend per its retention policy. To request immediate deletion of past events tied to your install ID, email privacy@ranga.ai with the install ID (visible in the Diagnostics card under Settings → Advanced).
Why we want it
Section titled “Why we want it”Honestly, mostly for crash diagnostics. Forge runs on a wide variety of Windows configurations and we can’t reproduce every issue locally. A stack trace tied to a build version and OS version, with no project content, lets us fix bugs without seeing your code.
If telemetry feels like an unreasonable trade for the diagnostic value you’d get, leave it off. Forge’s core functionality doesn’t depend on it.
Contact
Section titled “Contact”For telemetry questions, reach us at privacy@ranga.ai.