claude-extension-logging

Instrument Claude extension and shim to log directional traffic with distinct naming conventions.

2|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/tankygranny05/agent-box --skill claude-extension-logging
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claude-extension-logging
Source: https://github.com/tankygranny05/agent-box/tree/main/agent-box/seed/claude-skills/claude-extension-logging
Command: npx skills add https://github.com/tankygranny05/agent-box --skill claude-extension-logging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures that all communication between the Claude extension, its shim, and the webview/CLI is consistently logged, providing a reliable record for debugging and comparison with other systems.

Core Features & Use Cases

  • Consistent Logging: Instruments the Claude extension and shim to emit directional traffic logs.
  • Distinguishable Streams: Uses clear naming conventions (claude_* and claude_shim_*) to differentiate between extension and shim traffic.
  • Use Case: When debugging issues related to Claude's interaction with its UI or command-line interface, use this skill to capture all message exchanges, ensuring no data is lost and facilitating comparison with other logging systems like Codex.

Quick Start

Use the claude-extension-logging skill to instrument the Claude extension and shim for consistent log capture.

Frequently Asked Questions about claude-extension-logging

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

FAQPage Schema
How do I capture Claude extension traffic for debugging?▼

To capture Claude extension traffic for debugging, you instrument the extension and shim by appending JSON lines to specific files before dispatching messages, ensuring all directional traffic logs are consistently recorded.

What's the best way to log shim vs extension message paths separately?▼

To log shim vs extension message paths separately, apply distinct naming conventions using `claude_*` for extension traffic and `claude_shim_*` for shim traffic, allowing you to differentiate and compare communication streams.

How does CLI response wrapping work for Claude extension logging?▼

CLI response wrapping for Claude extension logging mirrors the extension envelope structure, ensuring command-line interface responses are formatted consistently with extension messages for unified observability and comparison.

Can I use this logging approach to compare Claude traffic with other observability systems?▼

Yes, you can use this logging approach to compare Claude traffic with other observability systems like Codex, as it captures all message exchanges in structured JSON lines to facilitate cross-system comparison.

Does Claude extension logging require any external dependencies?▼

Claude extension logging requires no external dependencies, operating by appending JSON lines to specific files and wrapping CLI responses without needing additional packages or libraries.

When do I need directional traffic logs for the Claude ecosystem?▼

You need directional traffic logs for the Claude ecosystem when debugging issues related to Claude's interaction with its UI or command-line interface, ensuring no message data is lost between the extension, shim, and webview.