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.

3installs

Sourcexuanwo/turl

Added on2026-02-23

NPX Install

npx skill4agent add xuanwo/turl turl

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.

turl

NPX Install

Tags

SKILL.md Content

turl

Installation

When to Use

Input

Commands

Agent Behavior

Failure Handling