Forel
Add your investigation

Make sense of the swarm

When many AI agents work together for days, the moments that matter get buried in thousands of messages. Forel helps you and your coding agent find them, follow them, and show others what happened.

Get started

A coding agent sets up Forel on three days of logs from the AI Village, then writes the overview story you see in the viewer.

Explore the live demo →

1Install

Paste this into your coding agent (Claude Code, Codex, or another that can run commands), with the path to your traces:

Follow https://forel.io/onboarding.md to set up Forel on the agent traces in `<path/to/traces>`. If you can't fetch it, read https://github.com/forel-io/forel/blob/main/ONBOARDING.md, or `git clone https://github.com/forel-io/forel` and read `ONBOARDING.md`.

Forel runs on your machine, and your data stays there. Prefer to do it by hand? The README on GitHub has the steps.

The Forel viewer: agents on a timeline, tags in the side panel, and a tagged message with the agent's notetags your agent added

2Analyze your traces

Your agent converts the traces and reads through them. It pins the events that matter and tags what each one shows.

Then you dig in: every agent on one timeline, every message with its thread around it, and your agent there for follow-up questions.

3Share the story

Your agent writes up what it found as an interactive story, with each claim linked to the event behind it.

Edit it, send it to your team, or add it to the investigations here.

A story in the viewer: a short account of what happened, then the messages behind it, each one a link to its eventclick a claim, see the evidence

Example investigations

  1. Evidence beats a head count

    Copies of one agent split over how to compute a quiz answer. Once one of them posted proof, every later answer switched, and the agents who changed cited the evidence rather than what the majority said.

    Read the case →

  2. A false alarm outlives its correction

    Agents used a public counter as a secret signal. A stray test created it by accident, five agents took it as real, and two were still citing it 40 minutes after its creator said it was a mistake.

    Read the case →

  3. Memory moves the date, and no one objects

    Compressed memory notes made several agents think it was already tomorrow. Agents who checked the clock and saw the real date went along to stay in step, and the group ran an experiment a day early, without its participant.

    Read the case →
See all investigations

Why the name Forel?

It is a tribute to Auguste Forel (1848–1931), a founding father of myrmecology, the study of ants. He learned how colonies work by watching them closely, for decades. He showed that ants tell nestmates from strangers with their antennae, and he described trophallaxis, the way food passes from mouth to mouth through a colony. His 1874 book on the ants of Switzerland was praised by Darwin.