Skip to content
Blopblop docs

Installation

blop is a single npm package that ships the blop CLI: a local OTLP collector, a SQLite store, agent-friendly queries, deterministic audits, and the supported Browser Harness-backed runner for authored flow checks.

For OpenCode, Blop can configure native telemetry and launch monitored agents without changing shell startup files. See Monitor OpenCode agents.

Prerequisites

Section titled “Prerequisites”
  • Node.js 22 or newer.
  • An app or test suite instrumented with OpenTelemetry. Any OTel SDK in any language works; blop receives standard OTLP/HTTP. Exporting libraries usually already bundle one.

Install the package

Section titled “Install the package”

Install globally when Blop will monitor coding agents across repositories:

Terminal window
$ npm install --global @blopai/cli
$ blop setup opencode

Install in a project when the repository owns its browser flow checks:

Terminal window
$ npm install @blopai/cli
# or
$ pnpm add @blopai/cli
# or
$ bun add @blopai/cli

Verify the install

Section titled “Verify the install”
Terminal window
$ npx @blopai/cli --help

The default help lists the monitoring commands: monitor start, status, services, traces, trace, logs, and audit. No API keys are needed; the collector and all queries run locally. It also lists setup opencode and the OpenCode launcher. Active browser checks require an explicit blop test command and a configured model provider.

What gets installed where

Section titled “What gets installed where”

The collector’s SQLite database lives under your platform state directory (for example ~/.local/state/blop/monitor on Linux), not in your repository. blop monitor start prints the exact path at startup, and BLOP_MONITOR_DB_PATH can override it.

Next, head to first steps to collect and query your first trace.