OthmaneBlial

Agent Flight Recorder

Name: Agent Flight Recorder
Author: OthmaneBlial

AI community

SOURCE https://github.com/OthmaneBlial/Agent-Flight-Recorder

Description

The local black box for AI coding agents — read-only forensic replay of tools, tests, retries, permissions, failures, and code evolution.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

Agent Flight Recorder

**The local black box for AI coding agents.**

Turn provider traces into a read-only forensic replay of prompts, tool calls, edits, tests, retries, permissions, failures, and code evolution—without sending the evidence to a cloud service.

[![Node.js 24.18.1+](https://img.shields.io/badge/Node.js-24.18.1%2B-5FA04E?style=flat-square)](#requirements) [![CI](https://img.shields.io/github/actions/workflow/status/OthmaneBlial/Agent-Flight-Recorder/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/OthmaneBlial/Agent-Flight-Recorder/actions/workflows/ci.yml) [![Latest release](https://img.shields.io/github/v/release/OthmaneBlial/Agent-Flight-Recorder?style=flat-square)](https://github.com/OthmaneBlial/Agent-Flight-Recorder/releases/latest) [![MIT licensed](https://img.shields.io/badge/license-MIT-F6C453?style=flat-square)](LICENSE) ![Local first](https://img.shields.io/badge/network-loopback--only-70D7DF?style=flat-square) ![No telemetry](https://img.shields.io/badge/telemetry-none-8DDD72?style=flat-square)

[**Explore the product tour and field manual →**](https://othmaneblial.github.io/Agent-Flight-Recorder/) · [**Run the private synthetic demo ↓**](#run-the-private-synthetic-demo)

![Agent Flight Recorder replay console](docs/assets/replay-console.png)

Agent Flight Recorder helps answer questions that chat history cannot: _What exactly ran? Which attempt failed? Was a permission result explicit or inferred? What changed on disk? What evidence is missing?_ It normalizes local provider evidence into an append-only SQLite timeline while preserving provenance and uncertainty behind every conclusion.

Replay means read-only playback of recorded evidence. Agent Flight Recorder never re-executes tools, commands, or agent actions. It is designed for coding-agent incident review and audit trails, not as a hosted production LLM APM platform.