JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 78
  • Score
    100M100P100Q93189F
  • License MIT

Local-first analytics dashboard for your AI coding assistant conversations

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@eeshans/howiprompt) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    How I Prompt

    Local-first analytics for your AI coding conversations — prompts, personas, trends, and a personal wrapped view.

    npm license node platform demo

    Live Dashboard • Live Wrapped • Source

    npx @eeshans/howiprompt

    Requirements: Node.js 18+. Works with Claude Code, Codex, Copilot Chat, Cursor, LM Studio, Pi, and OpenCode logs. The local package ships with analytics disabled.


    image
    image
    image

    Highlights
    Local-first pipeline Sync, parsing, feature extraction, scoring, and metrics run on your machine
    Multi-source support Claude Code, Codex, Copilot Chat, Cursor, LM Studio, Pi, and OpenCode
    Two ways to explore Standard dashboard plus a scroll-through wrapped experience
    Metrics that feel personal Vibe Coder Index, Politeness, activity trends, heatmaps, and personas
    Private by default Raw logs stay local and the npm package ships with analytics disabled
    Fast repeat refreshes Incremental rebuilds reuse the local DB, caches, and exclusions

    What it does

    How I Prompt syncs local AI conversation logs, computes prompting metrics on-device, and opens a browser dashboard with both an overview page and a scroll-through wrapped experience.

    That starts a local server and opens the dashboard. On first run, a setup wizard detects supported backends, lets you confirm sources, and then runs the pipeline.

    Options

    npx @eeshans/howiprompt --no-open     # don't auto-open browser
npx @eeshans/howiprompt --port 4000   # custom port
npx @eeshans/howiprompt --help        # usage info

    What Happens

    1. Detects supported local backends and writes setup to ~/.howiprompt/config.json
    2. Copies raw conversation data into ~/.howiprompt/raw/
    3. Parses and stores messages in a local SQLite database at ~/.howiprompt/data.db
    4. Extracts features and scores prompts for dashboard metrics (no model downloads needed)
    5. Writes ~/.howiprompt/metrics.json and serves the dashboard at localhost

    Subsequent refreshes are incremental and reuse the local database, caches, and configured exclusions.

    Self-Host On GitHub Pages

    If you want to publish your own stats as a static site:

    git clone https://github.com/eeshansrivastava89/howiprompt.git
cd howiprompt && npm install && npm run dev:cli
npm run publish

    Then commit data/demo/metrics.json and push to main. GitHub Actions deploys the site automatically from dist-static/.

    Hosted analytics is enabled when you add your own repository secrets. If these are missing, the deploy still works and analytics is omitted:

    • PUBLIC_POSTHOG_KEY
    • PUBLIC_POSTHOG_HOST

    You can also set the repository variable PUBLIC_ENABLE_ANALYTICS=false to explicitly disable analytics.

    Enable GitHub Pages in your repo settings and set the source to GitHub Actions.

    What You Get

    Dashboard Full Experience
    One-page overview of your stats Scroll-through "Wrapped" presentation
    howiprompt.eeshans.com howiprompt.eeshans.com/wrapped

    Metrics include: total prompts, conversation depth, activity heatmap, model usage, Vibe Coder Index (with explainability), Politeness (with explainability), persona classification (2×2: Detail Level × Communication Style), and trends.

    Data Sources

    Source Location
    Claude Code ~/.claude/projects/*.jsonl
    Codex ~/.codex/history.jsonl
    Copilot Chat macOS: ~/Library/Application Support/Code/… · Windows: %APPDATA%\Code\… · Linux: ~/.config/Code/…
    Cursor macOS: ~/Library/Application Support/Cursor/… · Windows: %APPDATA%\Cursor\… · Linux: ~/.config/Cursor/…
    LM Studio ~/.lmstudio/conversations
    Pi ~/.pi/agent/sessions
    OpenCode Current storage: macOS/Linux ~/.local/share/opencode/opencode.db · Windows %LOCALAPPDATA%\opencode\opencode.db; legacy JSON storage also works

    Supported file-based sources are auto-synced into ~/.howiprompt/raw/ and reused across refreshes. Parsed messages and derived metrics are stored in the local SQLite database at ~/.howiprompt/data.db.

    Backend Status

    • Supported today: Claude Code, Codex, Copilot Chat, Cursor, LM Studio, Pi, OpenCode

    Privacy

    • Local by default — Sync, parsing, scoring, and metrics run on your machine. No model downloads, no network access required
    • Persistent storage — Raw copies, local DB, config, and metrics live under ~/.howiprompt/
    • No prompt text leaves your machine — The app does not upload raw logs or prompt content
    • No analytics in the local app — The npx @eeshans/howiprompt package ships with analytics disabled. PostHog is only enabled on my demo website
    • Fully offline — Unlike previous versions, no ML model download is required. All scoring uses lightweight pattern matching with learned weights
    • Ancillary network requests — The dashboard loads ApexCharts from a CDN. The CLI checks npm for version updates. These do not transmit prompt data

    The 4 Personas

    Your persona is derived from two independent axes: Detail Level (brief → detailed) and Communication Style (directive → collaborative). These form a 2×2 grid validated on 21k prompts.

    • The Commander: Brief + Directive — short, decisive instructions
    • The Partner: Brief + Collaborative — quick exchanges, conversational flow
    • The Architect: Detailed + Directive — specs, constraints, numbered requirements
    • The Explorer: Detailed + Collaborative — context-rich, question-driven investigation

    Development

    # Install deps
npm install

# Build TypeScript
npm run build

# Run tests
npm test

# Rebuild package assets, then launch the CLI locally
npm run dev:cli

# Build the hosted demo site
npm run publish

# Build for distribution
npm run build:cli

# Privacy gate (run before npm publish)
npm run check:privacy

    Requirements

    • Node.js 18+

    Disclaimer: This is an independent personal project, not affiliated with, endorsed by, or connected to Anthropic or Claude in any way. This is a non-commercial, open-source tool created for personal use and educational purposes only.

    License

    MIT License — Not affiliated with Anthropic.