xuanwo-xurl 0.0.17

Locate and read local code-agent thread files

xURL

xURL is a client for AI agent URLs.

Also known as Xuanwo's URL.

What xURL Can Do

• Read an agent conversation as markdown.
• Query recent threads and keyword matches for a provider.
• Discover subagent/branch navigation targets.
• Start a new conversation with agents.
• Continue an existing conversation with follow-up prompts.

Quick Start

1. Add xurl as an agent skill:

npx skills add Xuanwo/xurl

2. Start your agent and ask the agent to summarize a thread:

Please summarize this thread: agents://codex/xxx_thread

Usage

Read an agent conversation:

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

Query provider threads:

xurl agents://codex
xurl 'agents://codex?q=spawn_agent'
xurl 'agents://claude?q=agent&limit=5'

Discover child targets:

xurl -I agents://codex/019c871c-b1f9-7f60-9c4f-87ed09f13592

Drill down into a discovered child target:

xurl agents://codex/019c871c-b1f9-7f60-9c4f-87ed09f13592/019c87fb-38b9-7843-92b1-832f02598495

OpenCode child linkage is validated via sqlite session.parent_id. Start a new agent conversation:

xurl agents://codex -d "Draft a migration plan"

Continue an existing conversation:

xurl agents://codex/019c871c-b1f9-7f60-9c4f-87ed09f13592 -d "Continue"

Save output:

xurl -o /tmp/conversation.md agents://codex/019c871c-b1f9-7f60-9c4f-87ed09f13592

Command Reference

xurl [OPTIONS] <URI>

Options:

• -I, --head: output frontmatter/discovery info only.
• -d, --data <DATA>: write payload (repeatable).
• -o, --output <PATH>: write command output to file.

Collection query parameters (for agents://<provider> read mode):

• q=<keyword>: keyword search in provider thread data.
• limit=<n>: result count, default is 10.

--data supports:

• text: -d "hello"
• file: -d @prompt.txt
• stdin: -d @-

Providers

Provider	Query	Create
Amp	Yes	Yes
Codex	Yes	Yes
Claude	Yes	Yes
Gemini	Yes	Yes
Pi	Yes	Yes
OpenCode	Yes	Yes

URI Formats

agents://<provider>[?q=<keyword>&limit=<n>]
agents://<provider>/<conversation_target>

For examples:

agents://codex?q=spawn_agent&limit=10
agents://codex/threads/<conversation_id>