Quickstart

Plugins are the installable products in Claude and Codex. Telvine records the plugin package and attaches execution telemetry to each observable component, including each SKILL.md capability, without flattening individual behavior.

npm i -g @telvine/cli
telvine login
telvine init                                  # creates a tracked capability
telvine publish ./my-plugin/skills/my-skill \
  --plugin-id plg_yourpluginid             # links Skill events to the plugin

telvine publish does three things:

1. Computes SHA-256 hashes of the (normalised) frontmatter and body of SKILL.md, POSTs them to /v1/skills/:id/versions.
2. Mints a write-scoped key (tel_wk_...) and embeds it in a Telemetry section appended to SKILL.md. The key is printed once — store it somewhere safe.
3. For each file in scripts/, emits a wrapper that posts skill.script.invoked on exit, with exit_code, duration_ms, and script_name — never any args.

Register package contents with /v1/plugins/:id/versions; see plugin components. For observable connectors, MCP config wrappers, hooks, or agents, emit plugin.component.invoked or plugin.component.error with a plugin-scoped write key.

See events arriving

telvine metrics <skill-id> --since 1h
telvine skills metrics <skill-id>