session-replay

Installation
SKILL.md

Session replay

Session replay answers "what did this user actually do?". It gives the click-by-click story behind an analytics number. The library fetches the rrweb recordings (rrweb is the open-source format that Mixpanel uses to record sessions), runs an analyzer on them, and gives you DataFrames plus a text timeline of actions.

Run code

The plugin keeps its own Python environment. Run the Python examples with ${CLAUDE_PLUGIN_DATA}/venv/bin/python script.py or ${CLAUDE_PLUGIN_DATA}/venv/bin/python -c "...". When the plugin environment exists, mp below means ${CLAUDE_PLUGIN_DATA}/venv/bin/mp; run it with that full path. Always write the full literal path, not a shell variable, because a variable expands to nothing and the command is denied.

If the interpreter path fails, the environment is not set up. Do not check again with ls, which, or shell variables: those commands are not allowed and prompt the user. Instead:

  1. Ask the user to run /mixpanel-headless:setup before any analysis code.
  2. For look-ups until then, run the bare command mp --version on its own (the mp on PATH, not the plugin path).
  3. If it shows 0.4.0 or later, use the bare mp help <query> for look-ups. An older version gives wrong answers, so do not use it.

A denial of some other command does not mean Bash is blocked. Still try the bare mp --version.

Do not run analysis code with a Python found on PATH, because it can hold a different library version or none at all. The one exception is a user's own project that already has mixpanel_headless (for example, a uv project), where uv run python works.

Workflow

Installs
1
GitHub Stars
19
First Seen
Oct 12, 2026