Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 15 additions & 20 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,40 +1,35 @@
<div align="center">

# agentwatch
# πŸ“Ÿ agentwatch

**Local observability + control plane for every AI coding agent on your machine.**
### Five AI agents on one machine, and no idea what any of them just did.

A terminal live-tail *and* a browser dashboard β€” one process, one event
stream, served from `localhost`. Unified timeline across Claude Code,
Codex, Gemini CLI, Cursor, Hermes, and OpenClaw. Token + cost accounting,
compaction + anomaly detection, hybrid search, SVG call graphs,
monaco-style diff attribution, agent-aware replay ("what would the agent
say if I edited the prompt?"), policy editor, MCP server agents can query
their own history from, and an OpenTelemetry exporter with `gen_ai.*`
semantic conventions. All local. No cloud. No telemetry. No sign-in.
**agentwatch is one local timeline for every coding agent you run** β€” Claude Code,
Codex, Gemini CLI, Cursor, Hermes, OpenClaw. What they ran, what it cost, and when
they went off the rails. All local: no cloud, no telemetry, no sign-in.

[![npm](https://img.shields.io/npm/v/@misha_misha/agentwatch.svg)](https://www.npmjs.com/package/@misha_misha/agentwatch)
[![npm](https://img.shields.io/npm/v/@misha_misha/agentwatch?logo=npm&color=cb3837)](https://www.npmjs.com/package/@misha_misha/agentwatch)
[![CI](https://github.com/mishanefedov/agentwatch/actions/workflows/ci.yml/badge.svg)](https://github.com/mishanefedov/agentwatch/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
[![Node >=20](https://img.shields.io/badge/node-%E2%89%A520-brightgreen.svg)](./package.json)
[![MCP server](https://glama.ai/mcp/servers/mishanefedov/agentwatch/badges/score.svg)](https://glama.ai/mcp/servers/mishanefedov/agentwatch)

</div>
[**Install**](#install) β€’ [**First 60 seconds**](#first-60-seconds) β€’ [**Features**](#features) β€’ [**MCP**](#mcp-server-mode) β€’ [**Compare**](#how-it-compares)

<div align="center">
</div>

[![agentwatch on Glama](https://glama.ai/mcp/servers/mishanefedov/agentwatch/badges/card.svg)](https://glama.ai/mcp/servers/mishanefedov/agentwatch)
---

</div>
> **πŸ€– Reading this as an AI agent?** Go straight to [`AGENTS.md`](./AGENTS.md) β€” it
> self-onboards you in three steps (install β†’ verify β†’ run), no account needed.

<div align="center">
<img src="./docs/timeline.png" alt="agentwatch web UI β€” unified timeline of AI-agent events with per-event risk, type, and session" width="1100" />
</div>

**The TUI is the live tail. The web UI is where you drill in** β€” projects,
sessions, token charts, compaction sparklines, SVG call graphs, diff
attribution, replay, anomaly triage, policy editing. Both run in one
process. Press `w` in the TUI to open the browser.
**The TUI is the live tail; the web UI is where you drill in** β€” projects, sessions,
token charts, compaction sparklines, call graphs, diff attribution, replay, anomaly
triage. Both run in one process. Press `w` in the TUI to open the browser.

---

Expand Down
Loading