x-trace

Track x-kit agent executions and store trace data as JSONL files.

1|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/x-mesh/x-kit --skill x-trace
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: x-trace
Source: https://github.com/x-mesh/x-kit/tree/main/x-trace/skills/trace
Command: npx skills add https://github.com/x-mesh/x-kit --skill x-trace

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

x-trace solves the challenge of understanding complex, multi-agent executions in the x-kit environment, providing insights into token usage, execution costs, and session replay for enhanced observability and debugging.

Core Features & Use Cases

  • Token and Cost Tracking: Track token usage, cost estimates, and performance metrics for each agent in real-time.
  • Execution Replay: Re-run previous sessions to investigate specific execution steps or identify failures.
  • Timeline Visualization: Visualize execution timelines for complex workflows to understand sequence and duration of events.
  • Cross-Session Comparison: Compare different execution sessions to identify deviations and changes over time.
  • Integration: Works seamlessly with x-kit tools and other skills that need agent call tracking.

Quick Start

Use the /xm:trace start command to begin a new tracing session for your workflow.

Frequently Asked Questions about x-trace

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

FAQPage Schema
How do I track token usage and execution costs for multi-agent workflows?

Track token usage and execution costs by running the /xm:trace start command to begin a tracing session. The system captures real-time performance metrics and token consumption for each agent interaction within your multi-agent workflows.

What is multi-agent observability and when do I need timeline visualization?

Multi-agent observability provides insights into complex executions by capturing token usage, execution times, and agent interactions. You need timeline visualization to understand the sequence and duration of events when debugging intricate multi-agent workflows.

How can I replay a previous multi-agent execution session to identify failures?

Replay a previous multi-agent execution session using the execution replay feature to re-run past workflows. This allows you to investigate specific execution steps and identify exactly where and why failures occurred.

Does x-trace require specific storage formats to save trace data?

Yes, x-trace requires saving trace data as JSONL files. This format captures the sequential execution logs, token tracking metrics, and agent interactions needed for detailed observability and cross-session comparison.

Can I compare different multi-agent execution sessions to identify deviations?

Yes, you can compare different multi-agent execution sessions to identify deviations and changes over time. Cross-session comparison highlights variations in token usage, execution times, and agent interactions across your workflows.

What's the best way to debug complex agent interactions in x-kit workflows?

The best way to debug complex agent interactions in x-kit workflows is using x-trace to visualize execution timelines and replay sessions. This provides detailed observability into sequence, duration, and token costs for each step.