v3.1.0

AgentOps Workbench v3.1.0

One-command install. Additive release — no breaking changes.

Install

curl -fsSL https://raw.githubusercontent.com/DevenDucommun/agentops-workbench/main/install.sh | sh
agentops --help

A single self-contained binary — no Bun, no clone, no PATH setup. The
installer detects your OS/arch (macOS and Linux, arm64/x64), downloads the
matching binary attached to this release, and installs it to /usr/local/bin
(override with AGENTOPS_INSTALL_DIR / AGENTOPS_VERSION). You can also
download a binary directly from the assets below. The Bun runtime and SQLite are
bundled in.

What's new

• Standalone binaries for macOS and Linux (arm64/x64), built with
  bun build --compile. Attached to this release by the release workflow.
• install.sh one-line installer.
• Dashboard assets are embedded at build time (with { type: "text" }) so the
  local dashboard works inside the compiled binary. No behavior change from
  source.

The Bun clone remains the development path (git clone + bun install). Npm
publication is still deferred. Binaries are ~60–90 MB each (the runtime is
bundled — that's the zero-dependency tradeoff).

Verification

bun run ci green (93 tests); the compiled binary runs the full CLI including
the dashboard.

v3.0.0

AgentOps Workbench v3.0.0

Breaking product simplification. Fewer commands and fewer concepts for the
user: two get-data-in intents and three save kinds. No change to ingestion
fidelity, report/gate/export output shapes, adapters, or the dashboard UI.

Migration

Ingest verbs: 4 → 2

There are now two intents instead of four overlapping commands.

Removed in v3.0.0	Use instead
agentops capture codex|claude <prompt>	agentops run codex|claude <prompt> --no-ingest (write the artifact only)
agentops capture ... --ingest	agentops run codex|claude <prompt> (ingests by default)
agentops import <artifact>	agentops audit <artifact> --quiet (ingest only, no verdict)

agentops run keeps all the former capture options (--output, --ephemeral,
--sandbox, --model, --profile, --include-hook-events,
--no-session-persistence, --permission-mode).

Save kinds: 6 → 3

Removed in v3.0.0	Use instead
agentops save repo-json	agentops save json --repo
agentops save trace	agentops save json --format openinference
agentops save gate	agentops check --save

agentops save is now report｜pr｜json. Removed kinds print a migration hint
instead of failing silently.

Also in this release

• Removed the stale wiki release step from the release template (the GitHub wiki
  is disabled).

Verification

bun run ci green (93 tests), smoke:dashboard and smoke:large-session pass.
Source-clone-with-Bun remains the supported install path; npm publication stays
deferred.

v2.0.0

AgentOps Workbench v2.0.0

Breaking release. A simplification pass that collapses the dual command
surface to a single set of simple verbs and consolidates the JSONL adapters.
Net −780 lines. The web dashboard is unchanged.

Migration (breaking)

Removed CLI commands → use the simple verb

Removed in v1.x	Use in v2.0.0
agentops inspect <id> / agentops review <id>	agentops look <id>
agentops report <id> --out f.md	agentops save report <id> --out f.md
agentops export <id> --format json	agentops save json <id> --out f.json
agentops export <id> --format json --scope repo	agentops save repo-json <id> --out f.json
agentops export <id> --format openinference-json	agentops save trace <id> --out f.json
agentops gate <id>	agentops check <id>
agentops gate <id> --format json|github	agentops check <id> --format json|github
agentops repo-report <id> --format github / agentops pr <id>	agentops save pr <id> --out f.md
agentops dashboard	agentops open
agentops ingest <artifact>	agentops import <artifact>
agentops show <id>	agentops look <id>

import and capture are retained (they are not pure duplicates of audit/run).

Removed adapter IDs → use agentops-jsonl

claude-code-jsonl, codex-jsonl, and pai-export-jsonl are consolidated into
agentops-jsonl. They shared one schema and parser; provenance is now read from
each record's source field. Pass canonical exports with no --adapter
(auto-detected) or --adapter agentops-jsonl. Adapters: 7 → 4.

Two niche sub-options dropped from the CLI

Not re-exposed on the simple verbs (the library functions remain):

• the Markdown-only repo report (repo-report --format markdown)
• export --include-raw-payloads

agentops check --format github covers the CI gate-comment case.

Also in this release

• agentops check gains --format text|json|github; --save now picks a
  format-aware default filename (agentops-gate.json / agentops-gate-comment.md
  / agentops-gate.txt).
• Removed packaging smoke scripts for the unshipped npm/binary path.
• Historical planning/research/release docs moved under docs/archive/.
• Removed a tracked generated report.md from the repo root.

Verification

bun run ci green (88 tests), smoke:dashboard and smoke:large-session pass.
Source-clone-with-Bun remains the supported install path; npm publication stays
deferred.

v1.11.0

Summary

• Adds simplified product commands: agentops status, agentops look, agentops check, agentops save, and agentops open.
• Makes no-argument agentops print the current status and recommended next commands.
• Keeps existing lower-level commands as advanced compatibility commands.
• Updates README, CLI, installation, dashboard, quality gate, roadmap, packaging, compatibility, and release docs around the simplified workflow.
• Extends smoke coverage for clone, packed package, and release archive paths.

Validation

• bun run ci
• bun run smoke:install
• bun run smoke:package
• bun run smoke:pack-install
• bun run smoke:large-session
• bun run smoke:dashboard
• bun test test/cli.test.ts
• bun run typecheck
• git diff --check

v1.10.0

Added

• agentops export --format openinference-json for deterministic OpenInference-style JSON span bundles.
• Session, event, command, risk, and token usage mapping into local span JSON.
• Export and CLI tests for deterministic output and raw payload omission.

Boundaries

• This is local JSON export, not OTLP/protobuf export.
• No collector upload, hosted service, or network export is added.

Verification

• bun run ci
• bun run smoke:install
• bun run smoke:package
• bun run smoke:pack-install
• bun run smoke:large-session
• bun run smoke:dashboard

v1.9.1

Changed

• Release archive smoke now expects all three MCP protocol tests.
• Public release metadata now points to v1.9.1.

MCP surface from v1.9.0

• agentops mcp remains the local stdio MCP server for read-only AgentOps evidence lookup.
• Tools cover session listing, session inspection, session reports, quality gates, and repo reports.

Verification

• bun run ci
• bun run smoke:install
• bun run smoke:package
• bun run smoke:pack-install
• bun run smoke:large-session
• bun run smoke:dashboard
• bun test test/mcp.test.ts

v1.9.0

Added

• agentops mcp, a local stdio MCP server for read-only AgentOps evidence lookup.
• MCP tools for session listing, session inspection, session reports, quality gates, and repo reports.
• MCP documentation covering client setup, stable tool names, and privacy boundaries.

Verification

• bun run ci
• bun run smoke:install
• bun run smoke:package
• bun run smoke:pack-install
• bun run smoke:large-session
• bun run smoke:dashboard
• bun test test/mcp.test.ts

v1.8.0

Added

• agentops init for one-command local setup, readiness checks, and one recommended next command.
• agentops doctor --fix for safe local setup fixes without overwriting existing config.
• agentops demo --serve for importing synthetic demo sessions and starting the local dashboard.

Verification

• bun run ci
• bun run smoke:install
• bun run smoke:package
• bun run smoke:pack-install
• bun run smoke:large-session
• bun run smoke:dashboard

v1.7.1

Changed

• agentops doctor now checks that .agentops/ is ignored by git.
• agentops demo now prints the local dashboard command with host/port and the dashboard URL.

Verification

• bun run ci
• bun run smoke:install
• bun run smoke:package
• bun run smoke:pack-install
• bun run smoke:large-session
• bun run smoke:dashboard
• bun run smoke:demo-artifacts

v1.7.0

Added

• agentops doctor for local readiness checks and recommended next command.
• agentops demo to import synthetic demo sessions and show immediate review, gate, and dashboard next steps.
• agentops audit <artifact> as a one-command import, review, and quality gate flow for saved JSONL artifacts or forensic transcripts.
• agentops pr [latest|session-id] as a short GitHub-ready repo report command.

Changed

• Top-level help now shows guided first-run commands first and moves lower-level commands under an advanced section.
• Empty session guidance now consistently points users to agentops demo, agentops audit, and agentops run.

Verification

• bun run ci
• bun run smoke:install
• bun run smoke:package
• bun run smoke:pack-install
• bun run smoke:large-session
• bun run smoke:dashboard
• bun run smoke:demo-artifacts