useractivity

CLI for UserActivity.ai — query behavioral data from the command line or pipe it to AI agents.

Setup

export USERACTIVITY_API_KEY="your-api-key"
export USERACTIVITY_SITE_ID="your-site-id"

Commands

npx useractivity status                    # Check tracking health
npx useractivity frustration               # Frustration signals (rage clicks, dead clicks, errors)
npx useractivity scroll                    # Scroll depth analysis
npx useractivity session                   # Session reconstruction
npx useractivity navigation                # Navigation flow (paths, drop-offs, loops)
npx useractivity engagement                # Engagement metrics (duration, return rate)
npx useractivity health                    # Visitor/pageview stats
npx useractivity context --output ctx.md   # Behavioral context as markdown
npx useractivity summary                   # Colored terminal summary

Options

--days <n>        Period in days (default: 30)
--format json     Machine-readable JSON output
--output <path>   Write to file (context command only)

License

MIT — UserActivity.ai