llms.txt
# ClawMetry
> Real-time observability and governance for 33 AI agent runtimes. The Grafana for your AI agents.
This file is written for AI agents and LLMs, not humans. It summarises ClawMetry, then links to the raw Markdown of every documentation page, grouped by feature, so you can fetch only the pages a question needs.
- Everything in one file: https://clawmetry.com/llms-full.txt
- The docs index on its own: https://clawmetry.com/docs/llms.txt
- Any docs page as Markdown: append `index.md` to its URL, for example https://clawmetry.com/docs/guard/overview/index.md
## What is ClawMetry?
ClawMetry is a free, open-source observability dashboard for AI agents. It gives you real-time visibility into what your AI agents are doing — token usage, cost per hour, sub-agent activity, cron jobs, memory changes, and session history — across every runtime you run.
## The 33 runtimes ClawMetry observes
Free on every plan: **OpenClaw**, **NVIDIA NemoClaw**, **Goose**.
Paid (Cloud Pro $19/node/month or Self-Hosted Pro): **Claude Code**, **Codex**, **Cursor**, **Aider**, **Gemini CLI**, **Muse Code** (Meta's terminal coding agent on Muse Spark), **Cline**, **OpenHands**, **OpenWorker**, **OpenExecutive** (Sente Labs' open-source AI executive team; the cost figure covers the Executive's own model calls, so it is a floor), **opencode**, **Qwen Code**, **Hermes**, **PicoClaw**, **NanoClaw**, **Pi**, **Deep Agents**, **n8n**, **Antigravity**, **GitHub Copilot**, **Grok Build**, **Grok Bot** (read from the Grok desktop client; spend is not observable and is reported as unavailable), **Devin** (the Devin CLI; Devin Cloud sessions are not read), **QM** (YC's multiplayer agent harness), **DeepSeek Harness** (DeepSeek's open-source `dsh` agent harness), **Exo** (the exoharness recursive agent harness), **Kimi CLI** (MoonshotAI's terminal agent, and its Kimi Code CLI successor), **Lovable** (lovable.dev's cloud app builder, read as a per-edit timeline from the project's GitHub-synced repo; no cost figures, no live indicator), **Replit Agent** (Replit's autonomous app-building agent; cost is reported as unavailable because Replit bills effort-based checkpoints server-side), and **OpenDots**.
For each runtime the ClawMetry daemon reads the runtime's native session store (JSONL, SQLite, or Postgres) in read-only mode. No SDK to add. No runtime code change. Per-runtime docs land under `https://clawmetry.com/runtimes/<name>` — `https://clawmetry.com/runtimes/qm` is the first, more roll out weekly.
## Key facts
- **License:** MIT (client) + closed pro adapters served only to activated installs
- **Install (macOS or Linux):** `curl -fsSL https://clawmetry.com/install.sh | bash`
- **Install (Windows):** `curl -fsSL https://clawmetry.com/install.cmd -o install.cmd && install.cmd`
- **Then:** `clawmetry connect` (or leave it local-only at `http://localhost:8900`)
- **Website:** https://clawmetry.com
- **GitHub:** https://github.com/vivekchand/clawmetry
- **PyPI:** https://pypi.org/project/clawmetry/
- **Platforms:** macOS, Linux, Windows, Raspberry Pi
- **Requirements:** Python 3.9+
- **Setup time:** about 30 seconds
## Documentation by feature
Every link below returns Markdown.
<!-- BEGIN docs index: generated by scripts/gen_docs.py, do not edit -->
## Get started
- [What is ClawMetry?](https://clawmetry.com/docs/start/what-is-clawmetry/index.md): ClawMetry is a local-first observability and governance layer for AI coding agents. It reads what 33 runtimes already write to disk and makes it answerable.
- [Install](https://clawmetry.com/docs/start/install/index.md): Install ClawMetry with pip, the one-line installer, Homebrew-style scripts, Docker, or the macOS desktop app — plus what each method actually sets up.
- [Quickstart](https://clawmetry.com/docs/start/quickstart/index.md): From pip install to reading your first agent session, answering your first cost question, and letting your coding agent query its own history.
- [How it works](https://clawmetry.com/docs/start/how-it-works/index.md): The sync daemon that owns the DuckDB writer lock, the three ingest paths, the localhost query server, and how the dashboard reads without contending for it.
- [Local, cloud, or self-hosted](https://clawmetry.com/docs/start/deployment-modes/index.md): The three ways to run ClawMetry — fully local, local compute with an encrypted cloud display, or a self-hosted ingest — and what each implies for your data.
- [Your first week](https://clawmetry.com/docs/start/first-week/index.md): An ordered sequence for getting real value out of ClawMetry — see the spend, set a budget, wire one alert, set retention, then decide whether Guard may act.
## Runtimes
- [Runtime support](https://clawmetry.com/docs/runtimes/overview/index.md): All 33 agent runtimes ClawMetry observes — OpenClaw, Claude Code, Codex, Cursor, Copilot, Gemini CLI, Goose, Cline, OpenHands and more — and what each exposes.
- [How detection works](https://clawmetry.com/docs/runtimes/detection/index.md): How ClawMetry finds agent runtimes — filesystem probes rather than PATH lookups, discovery order, environment overrides, and why one can be detected but empty.
- [What each runtime exposes](https://clawmetry.com/docs/runtimes/coverage/index.md): A side-by-side of what token and cost data every supported agent runtime genuinely persists — and where ClawMetry reports unknown rather than estimating.
- [Chat channels](https://clawmetry.com/docs/runtimes/channels/index.md): The 22 chat-channel adapters ClawMetry reads — Telegram, Signal, WhatsApp, Discord, Slack, iMessage, Matrix and more — and the concurrent-channel cap per tier.
- [Track any SDK agent](https://clawmetry.com/docs/runtimes/sdk-agents/index.md): Two lines of Python capture cost, tokens, latency and errors from any agent built on the OpenAI Agents SDK, LangChain, LlamaIndex, the Vercel AI SDK or httpx.
- [Custom runtime ingest API](https://clawmetry.com/docs/runtimes/custom-ingest/index.md): Push runs and events into ClawMetry over HTTP from any agent runtime — the endpoint reference, event payload schema, auth modes, and idempotency rules.
- [OpenTelemetry ingest](https://clawmetry.com/docs/runtimes/opentelemetry/index.md): Send OTLP traces, metrics and logs into ClawMetry from any agent framework, and export ClawMetry's own telemetry back out to your existing observability stack.
## Runtime reference
- [Aider](https://clawmetry.com/docs/runtime/aider/index.md): How ClawMetry observes Aider — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [Antigravity](https://clawmetry.com/docs/runtime/antigravity/index.md): How ClawMetry observes Antigravity — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [Claude Code](https://clawmetry.com/docs/runtime/claude-code/index.md): How ClawMetry observes Claude Code — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [Cline](https://clawmetry.com/docs/runtime/cline/index.md): How ClawMetry observes Cline — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [Codex](https://clawmetry.com/docs/runtime/codex/index.md): How ClawMetry observes Codex — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [Cursor](https://clawmetry.com/docs/runtime/cursor/index.md): How ClawMetry observes Cursor — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [Deep Agents](https://clawmetry.com/docs/runtime/deep-agents/index.md): How ClawMetry observes Deep Agents — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [DeepSeek Harness](https://clawmetry.com/docs/runtime/deepseek-harness/index.md): How ClawMetry observes DeepSeek Harness — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [Devin](https://clawmetry.com/docs/runtime/devin/index.md): How ClawMetry observes Devin — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [Exo](https://clawmetry.com/docs/runtime/exo/index.md): How ClawMetry observes Exo — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [Gemini CLI](https://clawmetry.com/docs/runtime/gemini-cli/index.md): How ClawMetry observes Gemini CLI — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [GitHub Copilot](https://clawmetry.com/docs/runtime/copilot/index.md): How ClawMetry observes GitHub Copilot — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [Goose](https://clawmetry.com/docs/runtime/goose/index.md): How ClawMetry observes Goose — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [Grok](https://clawmetry.com/docs/runtime/grok/index.md): How ClawMetry observes Grok — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [Grok Bot](https://clawmetry.com/docs/runtime/grok-bot/index.md): How ClawMetry observes Grok Bot — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [Hermes](https://clawmetry.com/docs/runtime/hermes/index.md): How ClawMetry observes Hermes — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [Kimi](https://clawmetry.com/docs/runtime/kimi/index.md): How ClawMetry observes Kimi — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [Lovable](https://clawmetry.com/docs/runtime/lovable/index.md): How ClawMetry observes Lovable — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [Muse Code](https://clawmetry.com/docs/runtime/muse-code/index.md): How ClawMetry observes Muse Code — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [n8n](https://clawmetry.com/docs/runtime/n8n/index.md): How ClawMetry observes n8n — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [NanoClaw](https://clawmetry.com/docs/runtime/nanoclaw/index.md): How ClawMetry observes NanoClaw — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [NemoClaw](https://clawmetry.com/docs/runtime/nemoclaw/index.md): How ClawMetry observes NemoClaw — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [OpenClaw](https://clawmetry.com/docs/runtime/openclaw/index.md): How ClawMetry observes OpenClaw — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [opencode](https://clawmetry.com/docs/runtime/opencode/index.md): How ClawMetry observes opencode — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [OpenDots](https://clawmetry.com/docs/runtime/opendots/index.md): How ClawMetry observes OpenDots — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [OpenExecutive](https://clawmetry.com/docs/runtime/openexecutive/index.md): How ClawMetry observes OpenExecutive — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [OpenHands](https://clawmetry.com/docs/runtime/openhands/index.md): How ClawMetry observes OpenHands — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [OpenWorker](https://clawmetry.com/docs/runtime/openworker/index.md): How ClawMetry observes OpenWorker — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [Pi](https://clawmetry.com/docs/runtime/pi/index.md): How ClawMetry observes Pi — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [PicoClaw](https://clawmetry.com/docs/runtime/picoclaw/index.md): How ClawMetry observes PicoClaw — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [QM](https://clawmetry.com/docs/runtime/qm/index.md): How ClawMetry observes QM — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [Qwen Code](https://clawmetry.com/docs/runtime/qwen-code/index.md): How ClawMetry observes Qwen Code — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
- [Replit Agent](https://clawmetry.com/docs/runtime/replit/index.md): How ClawMetry observes Replit Agent — where its data lives, the environment variables that move it, what cost data is real, and the traps in its store.
## Dashboard
- [Dashboard tour](https://clawmetry.com/docs/dashboard/overview/index.md): Every page of the ClawMetry dashboard, what question it answers, and where its data comes from — Home, Agents, Activity, Cost, Guard, Alerts and the rest.
- [Home](https://clawmetry.com/docs/dashboard/home/index.md): The ClawMetry overview page — live agent status, spend today, session activity timeline, health signals, and the badges that tell you something needs attention.
- [Agents](https://clawmetry.com/docs/dashboard/agents/index.md): The agent inventory — one row per agent on the node with its runtime, spend, liveness and owner, plus how liveness is actually derived.
- [Activity](https://clawmetry.com/docs/dashboard/activity/index.md): The live step-by-step feed of what every agent is doing — reasoning, tool calls, results and errors — with a streaming SSE endpoint and per-event drill-down.
- [Cost](https://clawmetry.com/docs/dashboard/cost/index.md): Token and spend analytics across every runtime and model — breakdowns, trends, cache efficiency, attribution, anomaly detection and the optimizer.
- [Conversations](https://clawmetry.com/docs/dashboard/conversations/index.md): Session transcripts across every runtime and chat channel — thinking split from replies, per-turn tokens and cost, tool timelines, compactions and sub-agents.
- [Approvals](https://clawmetry.com/docs/dashboard/approvals/index.md): The human-in-the-loop approval queue — how an agent asks permission, where the request surfaces, how a decision is delivered, and what if nobody answers.
- [Guard](https://clawmetry.com/docs/dashboard/guard/index.md): The Guard tab — live sessions ranked by spend at risk, detector incidents, Pause/Stop/Kill with honest per-session capability, and the policy decision log.
- [Alerts](https://clawmetry.com/docs/dashboard/alerts/index.md): Alert rules, webhooks and delivery channels — spend velocity, budget breaches, failure patterns and agent silence — and how to avoid alerts everyone mutes.
- [Developer views](https://clawmetry.com/docs/dashboard/developer/index.md): The deep-dive tabs — Flow, Models, LLM Context, Agent Graph, Tools, Context usage, Runtime extras and Ask — and what each one is genuinely useful for.
- [Advanced views](https://clawmetry.com/docs/dashboard/advanced/index.md): Schedules, Memory, Notifications, Logs, Security, Tool permissions, Skills, Self-Evolve, Version impact and NemoClaw governance.
## CLI reference
- [CLI overview](https://clawmetry.com/docs/cli/overview/index.md): Every ClawMetry command in one table, the global flags, the shape of --json output, and how the dashboard flags differ from the subcommands.
- [clawmetry](https://clawmetry.com/docs/cli/clawmetry/index.md): Running the ClawMetry dashboard — every flag, the background service subcommands, and the workspace and directory options.
- [onboard / setup](https://clawmetry.com/docs/cli/onboard/index.md): The ClawMetry first-run wizard — every flag, local-only mode, non-interactive cloud onboarding, and what the wizard actually does.
- [connect / disconnect](https://clawmetry.com/docs/cli/connect/index.md): Connecting a node to ClawMetry Cloud — every flag on connect, the ownership OTP, deferred sync, key-only mode, and how to cleanly disconnect.
- [sync](https://clawmetry.com/docs/cli/sync/index.md): The ClawMetry sync daemon — what it does on each cycle, how to start and restart it safely, running it in the foreground, and the environment that tunes it.
- [status](https://clawmetry.com/docs/cli/status/index.md): clawmetry status — the daemon, store and cloud state at a glance, the live one-line status bar, and the JSON envelope for scripting.
- [mcp](https://clawmetry.com/docs/cli/mcp/index.md): clawmetry mcp — start the Model Context Protocol server that lets coding agents query their own ClawMetry telemetry over stdio.
- [proxy](https://clawmetry.com/docs/cli/proxy/index.md): The ClawMetry enforcement proxy — budget limits, loop detection and model routing on port 4100, with every subcommand and flag.
- [eval](https://clawmetry.com/docs/cli/eval/index.md): clawmetry eval — run golden eval suites against your agents, watch mode for the dev loop, JSON output for CI, and regression replay of last week's failures.
- [tier, runtimes, features…](https://clawmetry.com/docs/cli/entitlement-commands/index.md): The entitlement inspection commands — tier, runtimes, features, channels, nodes, retention and bundle — with their JSON shapes and --why lock-reason payloads.
- [license / activate](https://clawmetry.com/docs/cli/license/index.md): Managing a self-hosted Pro or Enterprise license — activate, verify, deactivate, the machine fingerprint, and offline verification.
- [diagnose / verify-integrity](https://clawmetry.com/docs/cli/diagnose/index.md): clawmetry diagnose shows every input the entitlement resolver used; clawmetry verify-integrity checks the tamper-evident hash chain over local events.
- [update / uninstall / reports](https://clawmetry.com/docs/cli/maintenance/index.md): Keeping ClawMetry current, removing it completely, browsing generated reports, and inspecting loaded plugins.
- [Exit codes and JSON output](https://clawmetry.com/docs/cli/exit-codes/index.md): How ClawMetry commands behave in scripts and CI — exit codes, the shared --json envelope conventions, and patterns for monitoring wrappers.
## Agents & MCP
- [Let agents read their own telemetry](https://clawmetry.com/docs/mcp/overview/index.md): The ClawMetry MCP server gives Claude Code, Cursor and any MCP client their own session history, cost and traces — so a coding agent can diagnose itself.
- [Connect the MCP server](https://clawmetry.com/docs/mcp/install/index.md): Register ClawMetry's MCP server with Claude Code, Cursor, Codex, Goose and any other MCP client — with verification steps and the troubleshooting table.
- [MCP tool reference](https://clawmetry.com/docs/mcp/tools/index.md): Complete reference for the five ClawMetry MCP tools — arguments, defaults, limits, the query shape each one maps to, and the JSON-RPC calls behind them.
- [Self-diagnosis recipes](https://clawmetry.com/docs/mcp/self-diagnosis/index.md): Prompts and patterns for letting a coding agent diagnose itself — catching its own loops, checking whether it has failed this way before, and costing its plan.
- [Cross-runtime questions](https://clawmetry.com/docs/mcp/cross-runtime/index.md): ClawMetry's store holds every runtime on the machine, so an agent in one tool can c
