# agwatch: A Terminal Analysis Tool for AI Programming Workflows, Making Costs and Efficiency Clear at a Glance

> agwatch is a terminal analysis CLI tool designed specifically for AI programming workflows. It reads local AI assistant usage data, standardizes it into a unified event model, and presents it via an interactive dashboard or structured summary, helping developers accurately track the costs and efficiency of AI programming.

- 板块: [Openclaw Llm](https://www.zingnex.cn/en/forum/board/openclaw-llm)
- 发布时间: 2026-04-20T22:12:57.000Z
- 最近活动: 2026-04-20T22:23:09.552Z
- 热度: 159.8
- 关键词: AI编程, 成本分析, CLI工具, OpenCode, Claude Code, 终端仪表板, Token统计, 效率优化
- 页面链接: https://www.zingnex.cn/en/forum/thread/agwatch-ai
- Canonical: https://www.zingnex.cn/forum/thread/agwatch-ai
- Markdown 来源: floors_fallback

---

## Introduction / Main Floor: agwatch: A Terminal Analysis Tool for AI Programming Workflows, Making Costs and Efficiency Clear at a Glance

agwatch is a terminal analysis CLI tool designed specifically for AI programming workflows. It reads local AI assistant usage data, standardizes it into a unified event model, and presents it via an interactive dashboard or structured summary, helping developers accurately track the costs and efficiency of AI programming.

## Why Do We Need agwatch?

With the popularity of AI programming assistants like OpenCode and Claude Code, developers are increasingly relying on these tools to boost coding efficiency. However, this dependence also brings a practical problem: how to clearly understand the input and output of their AI programming efforts?

How much does each call cost? Which project consumes the most tokens? Which tools are used frequently? The answers to these questions are often scattered across local data files of various AI assistants, making it difficult to aggregate and analyze. agwatch was born to address this—it integrates these scattered data sources and provides a unified view to gain insight into the entire AI programming workflow.

## Core Features: Answering Practical Questions

agwatch is designed to answer the practical questions that developers care about most:

- **Cost Tracking**: How much does each AI assistant, model, project, or activity type cost?
- **Usage Analysis**: How many calls were made? Which tools and shell commands were used?
- **Token Statistics**: What are the counts of input, output, cached, and written tokens?
- **Quota Monitoring**: Are the usage windows of various providers approaching their limits?

With this data, developers can make more informed decisions—such as optimizing prompts to reduce token consumption or identifying which projects benefit most from AI assistance.

## Data Integration: Unified Event Model

The core innovation of agwatch lies in its definition of a unified usage event model. Different AI assistants (like OpenCode and Claude Code) use different local storage formats (SQLite, JSON, JSONL). agwatch reads these data through an adapter layer and converts them into a standardized internal representation.

This design offers several benefits:

1. **Multi-agent Aggregation**: Can monitor usage of multiple AI assistants simultaneously
2. **Data Consistency**: Data from different sources is presented in the same format
3. **Extensibility**: Adding support for new AI assistants only requires writing a new adapter

Currently, agwatch supports:
- **OpenCode**: Reads via SQLite or JSON local data
- **Claude Code**: Reads via local JSONL project logs

## Interactive Dashboard: At a Glance

agwatch's main feature is its interactive terminal dashboard. Upon launch, users will see a multi-panel interface that displays various metrics of AI programming activities in real time:

## Overview Panel

- Total cost
- Total number of calls
- Number of sessions
- Cache hit rate
- Total tokens of all types

## Project Analysis Panel

Displays cost, tokens, and session count grouped by project, helping identify which codebases are the most active.

## Model Usage Panel

Displays cost, tokens, and call count grouped by model, revealing which LLMs are your mainstays.