dashboard-expert
Dashboard Expert
Analyze, build, modify, and explain Mixpanel dashboards with mixpanel_headless. A dashboard is a list of rows. Each row holds one to four cells on a 12-column grid. A cell is a report (owned by this dashboard), a report link (owned by another dashboard, read-only), or a text card (HTML).
Run code with the plugin's Python environment: ${CLAUDE_PLUGIN_DATA}/venv/bin/python script.py or ${CLAUDE_PLUGIN_DATA}/venv/bin/python -c "...". Always write that full literal path, never a shell variable such as $CLAUDE_PLUGIN_DATA, because a variable expands to nothing in the shell and the command is denied.
If that interpreter path fails, the environment is not set up. Do not check again with ls, which, or shell variables; those checks are denied 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 only.
A denial of some other command does not mean Bash is blocked, so still try the bare mp --version.
Do not run analysis code with a Python or mp found on PATH, because its library version is unknown. The one other route is the user's own project: if it already has mixpanel_headless (for example a uv project), uv run python works.