### Install and Check Dependencies Source: https://github.com/jeanmeijer/slopmeter/blob/main/README.md Installs project dependencies and runs a check. Use this before building or running the CLI. ```bash bun install bun run check ``` -------------------------------- ### Install and run slopmeter globally Source: https://github.com/jeanmeijer/slopmeter/blob/main/packages/cli/README.md Install the slopmeter CLI globally on your system using npm. Once installed, you can run the slopmeter command from any directory. ```bash npm install -g slopmeter slopmeter ``` -------------------------------- ### Run slopmeter without installation Source: https://github.com/jeanmeijer/slopmeter/blob/main/packages/cli/README.md Execute the slopmeter CLI directly using npx without needing a global installation. This is useful for quick, one-off scans. ```bash npx slopmeter ``` -------------------------------- ### Build and Run CLI Source: https://github.com/jeanmeijer/slopmeter/blob/main/README.md Builds the project and then runs the CLI tool. The first command builds the project, and the subsequent commands show different ways to execute the CLI. ```bash # Build once bun run build # Run from built output node packages/cli/dist/cli.js # Run the CLI package directly in dev mode bun run --cwd packages/cli dev # Or if installed as a package binary slopmeter ``` -------------------------------- ### slopmeter CLI Usage Source: https://github.com/jeanmeijer/slopmeter/blob/main/packages/cli/README.md Displays the available command-line options for the slopmeter CLI. Use this to understand how to customize the heatmap generation. ```bash slopmeter [--all] [--claude] [--codex] [--cursor] [--gemini] [--opencode] [--pi] [--dark] [--format png|svg|json] [--output ./heatmap-last-year.png] ``` -------------------------------- ### Specify Output File and Format Source: https://github.com/jeanmeijer/slopmeter/blob/main/README.md Customizes the output file path and image format. The default output is a PNG heatmap. Explicit provider flags add suffixes to the default filename. ```bash # Output file (default: `./heatmap-last-year.png`; explicit provider flags add suffixes like `./heatmap-last-year_cursor.png`, and `--all` uses `./heatmap-last-year_all.png`) slopmeter --output ./out/heatmap.svg slopmeter -o ./out/heatmap.svg # Output format slopmeter --format png slopmeter --format svg slopmeter --format json slopmeter -f svg ``` -------------------------------- ### Enable Dark Theme and Merge Providers Source: https://github.com/jeanmeijer/slopmeter/blob/main/README.md Applies a dark theme to the generated heatmap and merges all provider data into a single graph. ```bash # Dark theme slopmeter --dark slopmeter --dark --format svg # Merge all providers into one graph slopmeter --all ``` -------------------------------- ### Filter Providers Source: https://github.com/jeanmeijer/slopmeter/blob/main/README.md Selectively renders heatmaps for specific AI coding assistants. If no provider flags are passed, all available providers are rendered. ```bash # Provider filters (optional) slopmeter --claude slopmeter --codex slopmeter --cursor slopmeter --gemini slopmeter --opencode slopmeter --pi ``` -------------------------------- ### Generate SVG heatmap with custom output path Source: https://github.com/jeanmeijer/slopmeter/blob/main/packages/cli/README.md Generates an SVG heatmap and saves it to a specified file path. This allows for scalable vector graphics output for custom use. ```bash npx slopmeter --format svg --output ./out/heatmap.svg ``` -------------------------------- ### JSON Export Configuration Source: https://github.com/jeanmeijer/slopmeter/blob/main/README.md Exports the heatmap data in JSON format for interactive rendering. The export includes provider details, daily usage, and insights. ```bash # Use --format json (or an .json output filename) to export data for interactive rendering. # Export includes fixed version: "2026-03-03". # Each provider includes: # - title and colors # - daily rows with date, input, output, cache, total # - daily[].breakdown per-model usage for that day, sorted by tokens.total (includes input and output) # - insights (mostUsedModel, recentMostUsedModel) when available ``` -------------------------------- ### Render merged graph across all providers Source: https://github.com/jeanmeijer/slopmeter/blob/main/packages/cli/README.md Generates a single, combined heatmap that merges data from all supported providers. This provides a holistic view of your coding activity across different AI tools. ```bash npx slopmeter --all ``` -------------------------------- ### Render dark-theme SVG heatmap Source: https://github.com/jeanmeijer/slopmeter/blob/main/packages/cli/README.md Generates an SVG heatmap with a dark theme applied, saving it to a specified output path. This option is useful for better visibility in dark environments. ```bash npx slopmeter --dark --format svg --output ./out/heatmap-dark.svg ``` -------------------------------- ### Generate JSON output for custom rendering Source: https://github.com/jeanmeijer/slopmeter/blob/main/packages/cli/README.md Outputs the heatmap data in JSON format to a specified file. This is useful for custom data visualization or integration with other tools. ```bash npx slopmeter --format json --output ./out/heatmap.json ``` -------------------------------- ### Environment Variables for File Processing Source: https://github.com/jeanmeijer/slopmeter/blob/main/README.md Configures limits for processing large files and records. These environment variables help manage memory usage for specific providers. ```bash # SLOPMETER_FILE_PROCESS_CONCURRENCY: positive integer file-processing limit for Claude Code and Codex JSONL files. Default: 16. # SLOPMETER_MAX_JSONL_RECORD_BYTES: byte cap for Claude Code and Codex JSONL records, OpenCode JSON documents, and OpenCode SQLite message.data payloads. Default: 67108864 (64 MB). ``` -------------------------------- ### Render only Gemini CLI usage heatmap Source: https://github.com/jeanmeijer/slopmeter/blob/main/packages/cli/README.md Generates a heatmap that includes data exclusively from Gemini CLI usage. This allows for a focused view of Gemini CLI activity. ```bash npx slopmeter --gemini ``` -------------------------------- ### Render only Pi Coding Agent usage heatmap Source: https://github.com/jeanmeijer/slopmeter/blob/main/packages/cli/README.md Generates a heatmap that includes data exclusively from the Pi Coding Agent. This isolates and visualizes activity related to this specific agent. ```bash npx slopmeter --pi ``` -------------------------------- ### Render only Cursor usage heatmap Source: https://github.com/jeanmeijer/slopmeter/blob/main/packages/cli/README.md Generates a heatmap that includes data exclusively from Cursor usage. This focuses the analysis on activity within the Cursor IDE. ```bash npx slopmeter --cursor ``` -------------------------------- ### Render only Codex usage heatmap Source: https://github.com/jeanmeijer/slopmeter/blob/main/packages/cli/README.md Generates a heatmap that includes data exclusively from Codex usage. This helps in analyzing activity specific to this provider. ```bash npx slopmeter --codex ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.