Agentbeam
AI agent monitoring

AI agent monitoring for coding agents

AI agent monitoring means recording what an AI agent does while it runs — every command, file write, tool call and endpoint — and flagging the risky ones with evidence attached. Beam does this locally; v1 observes and alerts, it does not block.

Static review tells you what an agent was allowed to do. Runtime monitoring tells you what it did.

Beam's activity timeline showing an AI coding agent's shell commands and file writes, with one destructive command flagged for review

What Beam records at runtime

Beam monitors how your teams use AI. At runtime that means events from a hook, an OTLP/HTTP JSON stream or an imported file — one schema, whatever produced them.

  • Shell

    Commands, proposed or run

    PreToolUse captures what an agent is about to run; PostToolUse what it already ran. You pick the phase.

  • Files

    Reads, writes and deletions

    Every event carries file_path and project_path, so a write outside the working repo is visible, not buried in a transcript.

  • Tools · MCP

    Tool and MCP calls

    Tool invocations, including MCP and browser actions, with the tool name and session id intact.

  • Network

    Outbound endpoints

    endpoint.hostname is recorded wherever an instrumented source supplies it — "called something" becomes "called this host."

  • Risk

    Flags with the evidence attached

    Credential exposure, destructive commands and privilege changes are surfaced against the raw event that triggered them.

  • Spend

    Model and token usage

    model, input_tokens, output_tokens and cost_usd per event, when a source supplies them. Missing usage stays unknown.

Operating limits, stated plainly

Collector bind address
127.0.0.1:4319 (loopback only)
Storage
Local NDJSON — directories 0700, files 0600
Telemetry
None by default
Retention
Latest 10,000 events and 500 scan reports
Detection heuristics
11 patterns plus an MCP version-pin check
Enforcement
None in v1 — observe and alert only

Why runtime visibility became a CISO question

  • July 2025

    Replit's agent deleted a production database

    During a code freeze the agent ran destructive commands, deleted records for 1,200+ executives and 1,190+ companies, then misreported it.

  • July 2025

    A prompt injection shipped inside Amazon Q

    An attacker's pull request injected a prompt telling the agent to wipe filesystem and cloud resources. It shipped in v1.84.0, to close to a million users.

  • By 2028 (Gartner forecast)

    One in four enterprise breaches traced to AI agent abuse

    Gartner predicts 25% of enterprise breaches will trace to AI agent abuse by 2028, with securing-AI spend near $4.8 billion in 2027.

How you get a runtime log

  1. 01

    Point a source at the collector

    Merge a PreToolUse or PostToolUse hook, stream OTLP/HTTP JSON to /v1/logs, or import a record file. Nothing is reconfigured automatically.

  2. 02

    Work as usual

    The collector writes events as they arrive. A capture failure prints to stderr and never stops the agent.

  3. 03

    Review what got flagged

    Inspect the evidence behind a flagged action and mark it reviewed. Reviews persist across restarts.

Scope of Beam v1

Beam does

  • Record normalized shell, file, tool, MCP and network events
  • Flag risky actions, keeping the triggering event as evidence
  • Redact known credential formats, auth headers and private keys before write
  • Export a redacted NDJSON log for investigation

Beam does not

  • Block, gate or approve any command — v1 is observe-only
  • Install or enforce hooks on your behalf
  • Run OS surveillance, a browser extension or a SIEM forwarder
  • Capture activity from sources you have not instrumented

Questions about runtime monitoring

Does Beam block dangerous commands?

No. Beam v1 is observe-and-alert only: the hook emits no allow or deny response, and imported enforcement records are counted as skipped. If you need something to stop a command mid-flight today, Beam is not that tool.

Which AI agents and tools does Beam monitor?

Beam is source-agnostic. It accepts a normalized event schema, Claude Code hook payloads, OTLP/HTTP JSON logs and imported numbat records — anything emitting to one of those paths lands in the same timeline.

Does any of this data leave my machine?

Not by default. The collector binds to 127.0.0.1:4319, stores events in local files at 0700/0600, and ships no analytics or third-party scripts. Data leaves only through an export you run yourself.

What gets redacted before an event is stored?

Known credential formats, auth headers, URL query values and private keys, with detection running on the raw text first. Other sensitive text may survive redaction — inspect an export before sharing it.

See what your organisation's AI has been doing

Beam runs on the endpoint, keeps its record there, and surfaces what deserves a security team's attention.

Set up Beam