Metadata-Version: 2.4
Name: xuanwo-turl
Version: 0.0.3
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Rust
Classifier: Topic :: Software Development
License-File: LICENSE
Summary: Locate and read local code-agent thread files
Keywords: codex,claude,thread,cli,rust
License-Expression: Apache-2.0
Requires-Python: >=3.8
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Homepage, https://github.com/Xuanwo/turl
Project-URL: Issues, https://github.com/Xuanwo/turl/issues
Project-URL: Repository, https://github.com/Xuanwo/turl

# turl

`turl` is a Rust CLI and library for locating and reading local code-agent thread files.

## Features

- Multi-agent thread resolution:
  - <img src="https://avatars.githubusercontent.com/u/14957082?s=24&v=4" alt="Codex logo" width="16" height="16" /> Codex
  - <img src="https://www.anthropic.com/favicon.ico" alt="Claude logo" width="16" height="16" /> Claude
  - <img src="https://opencode.ai/favicon.ico" alt="OpenCode logo" width="16" height="16" /> OpenCode
- Default output is markdown with user/assistant-focused content.
- `--raw` outputs raw thread records.
- Automatically respects official environment variables and default local data roots for each supported agent.

## Install

```bash
npx skills add Xuanwo/turl
```

## Agents

### Codex

- Supported URIs:
  - `codex://<session_id>`
  - `codex://threads/<session_id>`
- Examples:

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

### Claude

- Supported URI:
  - `claude://<session_id>`
- Example:

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

### OpenCode

- Supported URI:
  - `opencode://<session_id>`
- Example:

```bash
turl opencode://ses_43a90e3adffejRgrTdlJa48CtE
```

### Raw Output

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

