
Context Xray
Inspect and manage the live agent context window with Context X-Ray.
Install
npx skills add BuilderIO/agent-native --skill context-xray -g -a claude-code -y- Repository
- BuilderIO/agent-native7.6k
- Category
- AI and agents
- Updated
- 3d ago
- License
- MIT
- Context cost
- Lightabout 921 tokens
- Runs scripts
- No, instructions only
What it does
Inspect and manage the live agent context window with Context X-Ray. Use when context is getting large, the user asks what is in context, or stale tool results/files should be pinned, evicted, restored, or reported by an external host.
Context X-Ray
Context X-Ray is the framework's context garbage-collection surface. It shows the current thread's model-bound context as content-derived segments with token counts, then lets the user or agent pin, evict, or restore individual segments.
Actions
| Action | When to use |
|---|---|
context-manifest-get | Read the current manifest for a thread. Returns token totals, segment status, source, and whether changes are enforceable. |
context-preview-get | Compose the would-be system context for the current user/org/app without a live thread. Returns labeled system sections with provenance, governance tier, token counts, and bounded previews. Backs the Agent page Context tab. |
context-pin | Preserve a segment across future compaction/model calls. Use for task specs, acceptance criteria, user constraints, and other durable context. |
context-evict | Exclude a stale or irrelevant segment from future model calls. Eviction is reversible and never deletes chat history. |
context-restore | Undo a pin, evict, or summarize directive for a segment. |
context-report | External hosts can report their visible context inventory. These manifests are advisory unless Agent-Native owns the emitted content. |
context-compact | Compact the thread now: fold every not-yet-compacted message into observational memory instead of waiting for the post-turn threshold. Takes effect on the next model call; the transcript is unchanged. |
System Sections
Manifests now cover the system-prompt half of context, not just conversation
segments. Each system section carries a provenance label (framework-core,
actions-prompt, template, enterprise-workspace-core, sql-workspace,
legacy-app-default, organization, personal, memory, db-schema, tools,
model-overlay, runtime-context) and a governance tier:

