turl

Original：🇺🇸 English
Translated

Use the turl CLI to resolve Amp, Codex, Claude, or OpenCode thread URIs and print thread content in markdown or raw records.

9installs
Sourcexuanwo/turl
Added on

NPX Install

npx skill4agent add xuanwo/turl turl

Tags

Translated version includes tags in frontmatter
turl-cliuri-resolutionthread-contentmarkdown-outputraw-records

SKILL.md Content

View Translation Comparison →

turl

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

Installation

Install 
turl
from package 
xuanwo-turl
via 
uv
:
bash
uv tool install xuanwo-turl
turl --version

When to Use

  • The user gives an 
    amp://...
    , 
    codex://...
    , 
    codex://threads/...
    , 
    claude://...
    , or 
    opencode://...
    URI.
  • The user asks to inspect, view, or fetch thread content.

Input

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

Commands

Default output (filtered markdown with user/assistant messages):
bash
turl codex://019c871c-b1f9-7f60-9c4f-87ed09f13592
Raw JSONL output:
bash
turl codex://019c871c-b1f9-7f60-9c4f-87ed09f13592 --raw
Claude thread example:
bash
turl claude://2823d1df-720a-4c31-ac55-ae8ba726721f
Codex deep-link example:
bash
turl codex://threads/019c871c-b1f9-7f60-9c4f-87ed09f13592
OpenCode thread example:
bash
turl opencode://ses_43a90e3adffejRgrTdlJa48CtE
Amp thread example:
bash
turl amp://T-019c0797-c402-7389-bd80-d785c98df295

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.
  • The output could be long, redirect to temp files and read/grep it later.

Failure Handling

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