session-replay
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:
- Ask the user to run
/mixpanel-headless:setupbefore any analysis code. - For look-ups until then, run the bare command
mp --versionon its own (themponPATH, not the plugin path). - 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.