@sessionvision/install-wizard

Auto-detects your project and sets up sessionvision analytics tracking.

The wizard scans your project directory to identify your framework, package manager, and coding agent, then walks you through installing the sessionvision skills and CLI.

Usage

Run this once in your project's root directory:

npx @sessionvision/install-wizard

What it does

1. Detects your stack -- frontend framework (Next.js, React, Vue, Nuxt, static), backend (Rails, Django, Flask, Node), TypeScript usage, and package manager
2. Detects your coding agent -- Claude Code, Cursor, Windsurf, GitHub Copilot, Cline, or Aider
3. Flags existing analytics -- warns if another analytics library is already present
4. Installs skills -- copies sessionvision skill files into your project for your coding agent to use
5. Authenticates via OAuth -- connects your project to sessionvision and installs the CLI
6. Generates a setup prompt -- gives you a prompt to copy and paste into your coding agent to finish the integration

Options

| Flag | Description | |------|-------------| | --install-dir <path> | Target project directory (defaults to cwd) | | --debug | Enable debug logging |

Development

npm install
npm run build       # Build with tsup
npm run dev         # Build in watch mode
npm test            # Run tests (vitest)
npm run typecheck   # Type-check without emitting
npm run lint        # Lint src/ and tests/

Requires Node >= 18.