help

Analyze Forge token tracking and session logs to recommend configuration changes.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/lpjhelder/kronon-forge --skill help-lpjhelder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: help
Source: https://github.com/lpjhelder/kronon-forge/tree/main/skills/help
Command: npx skills add https://github.com/lpjhelder/kronon-forge --skill help-lpjhelder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Forge users often lack visibility into how Kronon/Forge commands consume tokens, which agents are most active, and which features are underutilized, leading to inefficient workflows and avoidable costs. This Skill centralizes usage telemetry analysis so you can identify costly patterns, missing practices like team usage, and misconfigured defaults that waste time or tokens.

Core Features & Use Cases

  • Telemetry aggregation: Reads token tracking and session history to summarize total records, top agents, and model distribution.
  • Usage analysis: Detects underutilized features (e.g., ecomode or /team) and highlights high-cost agent/model usage.
  • Actionable recommendations: Suggests configuration changes such as setting defaultExecutionMode, adopting ecomode, or adding review agents to save tokens and improve workflows.
  • Graceful degradation: Provides clear messaging and next steps when token or session data is missing so users can enable tracking and rerun analysis.

Quick Start

Analyze my Forge usage and recommend token-saving settings and workflow improvements.

Frequently Asked Questions about help

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

FAQPage Schema
How do I analyze Forge session logs to reduce token waste?

Analyze Forge session logs by reading local token-tracking and session-history files to identify inefficient workflows and high-cost model usage. This retrospective analysis reveals underutilized features like ecomode and suggests configuration changes to lower operational costs.

How do I check which Forge agents and models are consuming the most tokens?

Check token consumption by aggregating Forge usage telemetry from session-history and token-tracking data. This summarizes total records, top active agents, and model distribution to pinpoint high-cost usage patterns and misconfigured defaults.

Where does Forge store session history and token tracking data for usage analysis?

Forge stores session history and token tracking data locally in ~/.forge/state/session-history.json and ~/.forge/state/token-tracking.jsonl. These files capture agent usage, model distribution, and session metadata required for retrospective analysis.

What Forge configurations help optimize token usage and improve workflow efficiency?

Configurations that optimize token usage include setting defaultExecutionMode, adopting ecomode, and adding review agents. Analyzing your session logs provides concrete recommendations for applying these specific configuration changes to reduce costs.

Can I use Forge usage analysis if my token-tracking or session-history files are missing?

You can still use usage analysis with missing data because the tool provides graceful degradation. It delivers clear messaging and next steps to help you enable tracking and rerun the analysis when token or session data is absent.

Does Forge usage analysis require access to configuration files?

Forge usage analysis requires read access to token-tracking and session history files, and optionally reads ~/.kronon/.forge-config.json. This access is needed to compute agent counts, detect high-cost models, and produce concrete operational recommendations.