Insider

The BEAM accessory for agents, by agents.

Two friendly robots, the coding agents, hold a glowing striped lantern that smiles back at them. A developer in a hoodie holds a coffee mug and watches with a puzzled smile.

Insider is a runtime-evidence library for BEAM applications, built for coding agents. Today you use it in local development: it attaches to a running node, records a bounded, masked window of what the node did, and gives your agent that evidence as structured events, request traces and process snapshots.

What it gives your agent

Quick start

Install the observer CLI from Hex and put the directory Mix prints on your PATH. Your app needs no change: the observer loads Insider into the node. Start a dev node with --sname my_app and a cookie file made under umask 077. Replace ID with the session_id that start returns.

mix escript.install hex insider_lab
N=(--node "my_app@$(hostname -s)" --cookie-file "$HOME/.my_app.cookie")
insider-lab live capabilities "${N[@]}" --load   # first contact
insider-lab live welcome "${N[@]}"              # the agent's quick start
insider-lab live start "${N[@]}" --component logger --component telemetry
insider-lab live mark "${N[@]}" --session ID --label 'about to click Confirm'
insider-lab live digest "${N[@]}" --session ID --since-mark --human
insider-lab live events "${N[@]}" --session ID --cursor 0 --format compact
insider-lab live stop "${N[@]}" --session ID    # read the cleanup receipt

Then point your agent at the welcome document and let it drive. Found something wrong? insider-lab live report --category bug --message '…' files it locally. In an Insider checkout, mix insider.live in tools/insider_lab does the same. Getting started has the boot command, the Tidewave variant and when to add Insider to your app. The cheat sheet has the commands you use most.

When to reach for it

When not to

Insider and Tidewave

A friendly cartoon wave with a tool belt that holds a database, a magnifying glass and a wrench. A robot holds up a small striped lantern, Insider, on a clip, ready to hang it on the belt. A second robot and a developer with a coffee mug stand beside them.

Use Insider next to Tidewave, not instead of it. Tidewave evaluates code and queries the database inside the node. Insider records what happened while requests ran, and observes from outside the request path. In our trials, Tidewave, dev logs and a browser decided most outcomes. Insider supplied the deciding fact in a few: a request-only fact, or a stalled request path.

Status and safety

Documentation

The documentation index tells you, or your agent, which section to read for which task. Start with Getting started or the cheat sheet. Contributors start with Development.

Community

License

Insider is licensed under the MIT License. See LICENSE. The text under LICENSES/ covers only the third-party code listed in THIRD_PARTY_NOTICES.md.