ctx-stats

Show context-mode token usage and savings ratios for the current session.

2|Updated May 5, 2026
One-click install
npx skills add https://github.com/OrestesK/pi --skill ctx-stats-orestesk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ctx-stats
Source: https://github.com/OrestesK/pi/tree/main/packages/context-mode/skills/ctx-stats
Command: npx skills add https://github.com/OrestesK/pi --skill ctx-stats-orestesk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill makes context-mode usage transparent by showing how much context was saved during the current session, without requiring manual analysis of tool activity.

Core Features & Use Cases

  • Token Usage Summary: Displays context consumption and savings metrics for the active session.
  • Savings Ratio: Shows the proportion of data retained in the sandbox instead of the model context window.
  • Per-Tool Breakdown: Identifies how individual context-mode tools contributed to overall savings.
  • Read-Only Reporting: Presents current statistics without modifying or deleting indexed knowledge.
  • Use Case: Review context savings after a long coding session to understand how effectively context-mode reduced large-output processing overhead.

Quick Start

Ask the agent to show the context-mode statistics for the current session.

Frequently Asked Questions about ctx-stats

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

FAQPage Schema
How do I check context-mode token usage and savings for my current session?▼

Context-mode statistics display the context consumption and savings metrics for the active session, showing the proportion of data retained in the sandbox instead of the model context window.

How do I see per-tool context savings during a coding workflow?▼

Per-tool context savings are shown by requesting the session statistics report, which identifies how individual context-mode tools contributed to overall savings during coding and analysis workflows.

Does monitoring context savings modify my indexed knowledge base?▼

Monitoring context savings does not modify indexed knowledge, as it provides read-only reporting that presents current statistics without deleting or altering existing data.

What's the best way to review context-mode savings after a long coding session?▼

Review context-mode savings after a long coding session by prompting the agent for the statistics report, which reveals how effectively context-mode reduced large-output processing overhead.

Do I need the context-mode MCP statistics tool to track session token usage?▼

Tracking session token usage requires access to the context-mode MCP statistics tool, which generates the complete returned report preserved for inspection.