turl

Use this skill when you need to read a thread file by URI.

Installation

Install turl from package xuanwo-turl via uv:

uv tool install xuanwo-turl
turl --version

When to Use

• The user gives a codex://... or claude://... URI.
• The user asks to inspect, view, or fetch thread content.

Input

• A thread URI in one of these forms:
  • codex://<session_id>
  • claude://<session_id>

Commands

Default output (filtered markdown with user/assistant messages):

turl "codex://019c871c-b1f9-7f60-9c4f-87ed09f13592"

Raw JSONL output:

turl "codex://019c871c-b1f9-7f60-9c4f-87ed09f13592" --raw

Claude thread example:

turl "claude://2823d1df-720a-4c31-ac55-ae8ba726721f"

Agent Behavior

• If the user does not request --raw, use default markdown output first.
• If the user requests exact records, rerun with --raw.
• Return the command output directly.
• Do not infer or reinterpret thread meaning unless the user explicitly asks for analysis.

Failure Handling

• Surface turl stderr as-is.
• Common failures include invalid URI format and missing thread files.