# Glossary

> The terms Blop uses, with one definition each.

<!-- Generated by apps/docs/scripts/gen-reference.mjs. Do not edit. -->

Blop lets people and their coding agents observe, investigate and verify the software they change, locally first and optionally with a shared cloud workspace.

## Language

### Local plane

#### Local plane
Everything that runs on a developer's machine and works without an account: the collector, the Inspector, local telemetry and local memory.

#### collector
The local process that receives OpenTelemetry traces and logs from your app and coding agents and stores them on your machine.
_Avoid_: monitor, monitoring server, daemon

#### Inspector
The local web interface for browsing the collector's traces, logs, services and findings.
_Avoid_: dashboard, local web UI

#### trace
The record of one request or operation as it moves through your software, made up of spans.

#### span
One timed step within a trace, such as a database call or an HTTP request.

#### log
A timestamped message emitted by a service, kept alongside the traces it belongs to.

#### service
A named application or process that sends telemetry to the collector.

#### run
One command execution recorded by `blop run`, with the issues it saw. A run is not a trace.

#### issue
A failure the collector groups across runs and telemetry, with a state: open, muted or fixed.

#### audit
A deterministic pass over local telemetry that produces findings.

#### finding
An audit result with trace and span evidence attached.
_Avoid_: insight (when the result is local)

#### local memory
Notes and findings saved on your machine that your agent can recall later, without an account.
_Avoid_: local brain, local graph

### Verification

#### browser check
A `.blop.ts` file, run with `blop test`, that drives a real browser to confirm a behaviour works.
_Avoid_: active check, authored check, flow verification, E2E test, intent-based test

#### check run
One execution of browser checks or another test suite (Vitest, JUnit), recorded in Blop Cloud.
_Avoid_: run, test run

#### Browser Harness
The controlled browser tooling that browser checks and other agents use to operate real browsers.
_Avoid_: harness (when it stands alone)

#### provider
The model provider that powers a browser check.

### Blop Cloud

#### Blop Cloud
The hosted web app where teams keep projects, runs and shared memory, and manage Blop from the browser, CLI or hosted MCP.
_Avoid_: web app, control plane, hosted app

#### workspace
A team's space in Blop Cloud. It holds projects, members and enabled apps.

#### project
One software product within a workspace, which groups its runs, findings and knowledge.

#### organization memory
Knowledge, rules and procedures a team has chosen to share, with sources and revision history, that agents can recall.
_Avoid_: organizational brain, knowledge graph, team memory

#### app
A feature of Blop Cloud that a workspace owner can turn on or off for the workspace.

### Agents

#### coding agent
An AI tool that edits code on your behalf, such as Claude Code or Codex, and which Blop observes and supports without taking control.

#### hook
An integration point that lets Blop capture a coding agent's activity as telemetry.

#### skill
A packaged set of instructions, as a `SKILL.md` file, that a coding agent can load for a specific task.