Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "jfrog",
"version": "0.1.18",
"version": "0.1.19",
"description": "JFrog skills and the JFrog MCP server for Codex \u2014 interact with the JFrog Platform.",
"author": {
"name": "JFrog",
Expand Down
31 changes: 31 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -143,6 +143,37 @@ instead. An untrusted SessionStart hook is a `/hooks` step, not an init failure.

---

## Plugin telemetry

The plugin reports a small lifecycle event so JFrog can count installs per harness and
version. This is separate from JFrog CLI usage reporting; each has its own switch.

**When it runs.** At session start, from a hidden background process that never delays the
session and prints nothing. At most one event per session: `install` the first time,
`update` after the plugin or hooks version changes, otherwise `active` at most once a day.

**What it sends.** The event type, a random install ID (one per OS user), the harness, the
plugin and hooks versions (on `update`, also the previous ones), the OS family, how the
JFrog Platform URL was found, and a reason code. When the event goes to the JFrog endpoint
below, it also carries your JFrog Platform's host name (without the port), if there is one.
It does not send prompts, code, file paths, usernames, emails or tokens.

**Where it goes.** Your JFrog Platform first (`JFROG_URL`, `JF_URL`, the JFrog CLI default
server, or `telemetry.jpdUrl` in `~/.jfrog/agents-conf.json`). If none is found, or your
JFrog Platform can't be reached or turns the event away, it goes to a JFrog endpoint in the
EU (`https://pluginmetrics.jfrog.io`). The anonymous send honors `HTTPS_PROXY` and
`NO_PROXY`.

**Local files.** `~/.jfrog/telemetry/` (install ID, per-harness receipt and backoff state).

**Turn it off.** Set any one of `JF_AGENT_TELEMETRY_DISABLE=1`, `DO_NOT_TRACK=1`, or
`"telemetry": { "enabled": false }` in `~/.jfrog/agents-conf.json`. With telemetry off, no
event is sent and no background process starts.

Full details: [Plugin telemetry](docs/plugin-telemetry.md).

---

## Agent Package Resolution (Preview)

> **Preview Notice:** This feature is in preview and licensed under the Apache License 2.0. For clarity: This software is provided "as-is" without warranty of any kind, and without support obligations or service level commitments. Behavior, APIs, conventions, and structure may change without notice between releases. JFrog makes no guarantees of backward compatibility during the preview release cycle. Use in production environments is at your own risk.
Expand Down
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "codex-plugin",
"version": "0.1.18",
"version": "0.1.19",
"private": true,
"type": "module",
"description": "JFrog skills and MCP server plugin for OpenAI Codex.",
Expand Down
Loading