turl

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

turl

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

当你需要通过URI读取对话线程文件时，可以使用这个工具。

Installation

安装

Install

turl

from package

xuanwo-turl

via

uv

bash

uv tool install xuanwo-turl
turl --version

通过

uv

从

xuanwo-turl

包安装

turl

：

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.

用户提供

amp://...

、

codex://...

、

codex://threads/...

、

claude://...

或

opencode://...

格式的URI。

用户要求查看、检查或获取对话线程内容。

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>
```

以下格式之一的对话线程URI：

```
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

默认输出（带用户/助手消息的过滤后markdown格式）：

bash

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

原始JSONL格式输出：

bash

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

Claude线程示例：

bash

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

Codex深度链接示例：

bash

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

OpenCode线程示例：

bash

turl opencode://ses_43a90e3adffejRgrTdlJa48CtE

Amp线程示例：

bash

turl amp://T-019c0797-c402-7389-bd80-d785c98df295

Agent Behavior

Agent行为规范

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.

如果用户未要求
```
--raw
```
，优先使用默认的markdown格式输出。
如果用户要求精确记录，使用
```
--raw
```
参数重新运行命令。
直接返回命令输出结果。
除非用户明确要求分析，否则不要推断或重新解释线程内容。
输出内容可能较长，可重定向到临时文件后再读取或使用grep筛选。

Failure Handling

故障处理

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

直接显示
```
turl
```
的标准错误输出。
常见故障包括URI格式无效和线程文件缺失。