Context X-Ray

SkillAI & models

context-xray is a skill that lets your AI analyze how much context your local Codex and Claude Code sessions use. Once added, your AI can visualize that usage, open a report, flag warnings, and suggest ways to optimize your prompts and tooling. The result is a clear picture of what is filling up your context and what to change.

Available today. Use it from your connected AI after setup.

After adding it, ask your AI to analyze the context usage of your Codex or Claude Code sessions and open the report. Then try its suggestions for improving prompts or tooling.

Then ask your AI: use the Context X-Ray skill

What your AI can do with it

  • Visualize how much context your local Codex and Claude Code sessions use
  • Open a report on context usage
  • Flag warnings about context usage
  • Suggest prompt optimizations
  • Suggest tooling optimizations

What this skill tells your AI

The instructions your AI receives, as published by builderio/agent-native in skills/context-xray/SKILL.md and read by ahel’s review.

Use Context X-Ray when a local coding-agent thread is getting large or the user wants to understand where context is going.

Setup

Recommended install path:

npx @agent-native/core@latest skills add context-xray --client all

That installs a local context-xray command plus Codex/Claude skills and slash commands. It does not need hosted auth or a remote MCP connector to read local transcript files.

Use --scope project when you only want project .agents skill and command artifacts added to the current repo.

Run

Current or most recent local thread:

context-xray --open

Recent thread picker:

context-xray threads --open

Weekly trends:

context-xray trends --since 7d --open

--open opens the generated local HTML file directly in the browser; it does not keep a background server running.

After running, summarize the report link, sessions analyzed, largest context buckets, warnings, and concrete optimizations.

Signals

GitHub stars
5k
Forks
440
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
context-xray
Source
github.com/builderio/agent-native