telemetry

Centralize Citadel telemetry data with session costs, spend totals, and controls.

820|78|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/SethGammon/Citadel --skill telemetry-sethgammon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: telemetry
Source: https://github.com/SethGammon/Citadel/tree/main/skills/telemetry
Command: npx skills add https://github.com/SethGammon/Citadel --skill telemetry-sethgammon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a centralized surface to view Citadel's telemetry data, including session costs, daily spend, all-time totals, hook activity, and trust level, plus a directory of available telemetry commands to manage and explore the system.

Core Features & Use Cases

  • Visibility: view current session costs, today’s spend, and all-time totals.
  • Control: toggle telemetry on/off and adjust cost alert thresholds.
  • Insights: review hook activity, trust level, and the command directory to navigate telemetry capabilities.
  • Use Case Example: auditing costs and telemetry activity by exploring /telemetry and related commands.

Quick Start

Open /telemetry to view the hub and configure alerts with /telemetry --threshold.

Frequently Asked Questions about telemetry

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track real-time session costs and token usage in Citadel?

To track real-time session costs and token usage in Citadel, use the telemetry Skill, which centralizes live token data, fallback log estimates, and all-time totals into a single dashboard surface.

Can I configure cost alert thresholds for my telemetry campaigns?

Yes, you can configure cost alert thresholds for telemetry campaigns by running the command /telemetry --threshold, which adjusts safety controls and spend limits sourced from harness.json configurations.

How does telemetry labeling distinguish between real data and estimates?

Telemetry labeling distinguishes data provenance by explicitly tagging every surfaced metric as real, est, or override, ensuring you know whether values come from live token sources or fallback log estimates.

What is the best way to monitor hook activity and trust level in Citadel?

The best way to monitor hook activity and trust level in Citadel is through the telemetry hub, which displays current session metrics and system trust status sourced directly from .claude/harness.json.

Can I disable telemetry collection if I want to pause cost tracking?

Yes, you can disable telemetry collection through the telemetry dashboard's safety controls, which allow you to toggle tracking on or off across campaigns without losing historical all-time spend totals.

Why does my Citadel telemetry dashboard show estimated costs instead of live token data?

Your Citadel telemetry dashboard shows estimated costs when live token data is unavailable, automatically falling back to log-based estimates and labeling them as est to maintain transparent data provenance.