JSPM

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

Local-first profiling for AI coding agents.

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 (agent-profiler) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    agent-profiler

    Local-first profiling for AI coding agents.

    agent-profiler captures local Cursor and Codex hook events into SQLite so you can inspect recent sessions, setup state, and always-on context overhead without sending data to a remote service.

    Requirements

    • Node.js 22 or newer
    • macOS, Linux, or another environment supported by better-sqlite3

    Install

    For one-off commands, use npx:

    npx agent-profiler --help
npx agent-profiler last

    For persistent hook installation, install the package so agent-profiler is available on PATH:

    npm install -g agent-profiler
agent-profiler --help

    Quick Start

    Initialize hooks for Cursor:

    agent-profiler init cursor --mode prod

    Initialize hooks for Codex:

    agent-profiler init codex --mode prod

    Inspect the resulting setup and the latest captured session:

    agent-profiler status
agent-profiler last
agent-profiler audit context

    npx vs --mode prod

    • npx agent-profiler ... is great for one-off inspection commands.
    • agent-profiler init <source> --mode prod writes persistent hook commands that expect agent-profiler to be installed on PATH.
    • --mode dev is meant for local development in this repository and writes absolute node <repo>/dist/cli.js ... hook commands instead.

    Commands

    • agent-profiler init <cursor|codex>: install hook wiring for a supported source
    • agent-profiler hook <source> <eventName>: ingest one hook payload from stdin
    • agent-profiler status: inspect local setup and ingest state
    • agent-profiler last: summarize the most recent observed session
    • agent-profiler audit context: estimate always-on context token footprint

    Releases

    Releases are automated with semantic-release. Pull requests run CI plus canary publishing, and pushes to main publish to npm and create a GitHub release.