{"name":"agentwatch: Monitor AI Agent Activity Locally","description":"agentwatch combines logs from multiple coding agents into a local timeline with event details, cost tracking, alerts, and search. It suits developers who run several agents and want visibility without sending data to a cloud service.","github":"https://github.com/mishanefedov/agentwatch","url":"https://osrepos.com/repo/mishanefedov-agentwatch","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/mishanefedov-agentwatch","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/mishanefedov-agentwatch.md","json":"https://osrepos.com/repo/mishanefedov-agentwatch.json","topics":["typescript","developer-tools","ai-agents","observability","local-first","multi-agent","agent-monitoring","token-cost-tracking"],"keywords":["typescript","developer-tools","ai-agents","observability","local-first","multi-agent","agent-monitoring","token-cost-tracking"],"stars":null,"summary":"agentwatch combines logs from multiple coding agents into a local timeline with event details, cost tracking, alerts, and search. It suits developers who run several agents and want visibility without sending data to a cloud service.","content":"## Overview\n\nagentwatch is a local observability tool for developers running multiple AI agents on one machine. It reads agent session and configuration files and brings supported activity into a shared timeline, helping users investigate unexpected actions, compare costs, and understand what happened across separate sessions.\n\nIt is most useful when switching between agents makes their independent logs difficult to follow. It is a viewer rather than an agent runner or background capture service, and its terminal interface can launch a local web UI for deeper inspection.\n\n## Key Features\n\n- Combines supported agent events in a live terminal timeline, with a local web interface for session details.\n- Tracks token usage and estimated costs, including cache accounting for supported models.\n- Provides event details, session search, exports, and subagent drilldown where the source data supports it.\n- Flags cost, duration, and token outliers, as well as repeated event loops.\n- Supports configurable session and daily budget alerts and user-defined notification triggers.\n- Offers an MCP server for querying session history and an optional OpenTelemetry exporter.\n- Reads local agent logs and settings; the project states it has no telemetry and makes no network calls unless an OTLP endpoint is configured.\n\n## Use Cases\n\n- Developers using Claude Code alongside Codex, Gemini CLI, or other supported agents can review activity in one timeline instead of checking separate logs.\n- A developer investigating a surprising file change or command can inspect event details and session history to trace what the agent did.\n- Users managing agent spend can monitor session and daily budgets and investigate unusually costly turns.\n- Teams or individuals diagnosing repeated agent retries can use anomaly indicators to spot likely loops.\n- Developers with an observability stack can optionally export agent events as OpenTelemetry spans.\n\n## Project Facts\n\n- Language: TypeScript\n- License: MIT\n- Stars: 15\n- Forks: 0\n- Topics: ai-agents, claude-code, cli, cursor, developer-tools, local-first, mcp, observability, openclaw, tui\n- Archived: No\n\n## Getting Started\n\nRequires Node.js 20 or later and macOS or Linux. Install and run:\n\n```bash\nnpm i -g @misha_misha/agentwatch\nagentwatch\n```\n\nSee the [README](https://github.com/mishanefedov/agentwatch#readme) for agent coverage, configuration, and usage details.\n\n## Alternatives\n\n- [agenttrail](https://osrepos.com/repo/sodiumsun-agenttrail): Agenttrail maps file changes and agent activity in a 3D task view, while agentwatch focuses on searchable event timelines, costs, and alerts.\n\n## Considerations\n\n- It captures activity while the TUI is running. It is not a background daemon, and startup backfill is bounded.\n- Agent coverage varies. Cursor activity is limited to configuration data, while some other agents do not persist all event details that the tool can display.\n- Windows is out of scope for the current v0.x release; documented support is for macOS and Linux.\n- Node.js 20 or later is required. The repository describes the project as v0.0.3 in its agent coverage notes, so capabilities and support may evolve.\n- Cost and token-attribution figures can involve estimates for some categories. The README notes that its tokenizer is approximate for Claude, while usage records provide exact model-reported input, cache, and output counts where available.","metrics":{"detailViews":2,"githubClicks":0},"dates":{"published":null,"modified":"2026-10-06T07:47:22.000Z"}}