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.