百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
X

xurl

> 编程语言
开源

xURL: 面向 AI 代理程序的 URL 客户端

357 stars0 点赞0 次浏览
访问官网GitHub

工具介绍

xURL: 面向 AI 代理程序的 URL 客户端

xURL

xURL is a CLI that reads, queries, and writes AI agent conversations through a unified agents:// URI scheme.

Also known as Xuanwo's URL.

What xURL Can Do

xURL gives you one URI scheme (agents://) to read, query, discover, and write conversations across multiple AI agent CLIs.

  • Read a conversation as markdown — xurl agents://codex/
  • Query threads by provider, keyword, local path, or role — xurl 'agents://codex?q=refactor'
  • Discover child targets and metadata before drilling down — xurl -I agents://codex/
  • Write to start or continue a conversation — xurl agents://codex -d "hello"

Providers

agents://amp

agents://claude

agents://codex

agents://copilot

agents://cursor

agents://gemini

agents://kimi

agents://opencode

agents://pi

Installation

Install as an agent skill:

bash
npx skills add Xuanwo/xurl

Or install the standalone CLI:

bash
brew tap xuanwo/tap && brew install xurl   # Homebrew
cargo install xurl-cli                      # Cargo
uv tool install xuanwo-xurl                 # Python / uv
npm install -g @xuanwo/xurl                 # npm

Quick Start

Ask your agent to summarize a thread:

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

Usage

Note: The agents:// scheme prefix is optional — codex/... is equivalent to agents://codex/....

Read

bash
xurl agents://codex/019c871c-b1f9-7f60-9c4f-87ed09f13592
xurl agents://copilot/688628a1-407a-4b4e-b24a-1a250ebf864f

Save output to a file:

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

Query

By provider:

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

By local path:

bash
xurl agents:///Users/alice/work/xurl
xurl 'agents:///Users/alice/work/xurl?q=refactor&limit=5'
xurl 'agents://.?q=refactor&providers=codex,claude'
xurl 'agents://~/work/xurl?providers=opencode'

By role:

bash
xurl agents://codex/reviewer

Query results include reduced thread metadata when available, so you can inspect fields like payload.git.branch without opening each thread individually.

Discover

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

Frontmatter includes provider metadata flattened into readable key-value lines (e.g. payload.git.branch = ...), and skips oversized instruction-like fields.

Drill down into a discovered child target:

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

Write

Start a new conversation:

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

Start with a role URI:

bash
xurl agents://codex/reviewer -d "Review this patch"
xurl agents://copilot/research -d "Investigate the failing integration test"

Continue an existing conversation:

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

Pass extra parameters to the provider CLI via query string:

bash
xurl "agents://codex?cd=%2FUsers%2Falice%2Frepo&add-dir=%2FUsers%2Falice%2Fshared&model=gpt-5" -d "Review this patch"

Command Reference

bash
xurl [OPTIONS] 
  • -I, --head: output frontmatter/discovery info only, including the first provider metadata record flattened into key-value lines when available.
  • -d, --data : write payload (repeatable).
    • text: -d "hello"
    • file: -d @prompt.txt
    • stdin: -d @-
  • -o, --output : write command output to file.

Error Output

xurl writes actionable stderr errors for agents:

  • unsupported providers and unsupported capabilities include requested_uri, suggested next_steps, and the GitHub issue link for requesting support
  • missing local data includes evidence such as searched_roots so the next recovery step is explicit
  • provider CLI failures include the command, exit code, and concrete retry guidance

URI Reference

Agents URI

[agents://][/[/]][?]
|------|  |--------|  |---------------------------|  |------|
 optional   provider         optional path parts        query
 scheme
  • scheme: optional agents:// prefix. If omitted, xurl treats input as an agents URI shorthand.
  • provider: target provider name, such as amp, claude, codex, copilot, cursor, gemini, kimi, opencode, pi.
  • token: main conversation identifier or role name.
  • child_id: child/subagent identifier under a main conversation.
  • query: optional key-value parameters, interpreted by context.

Path-Scoped Query URI

agents:///abs/path[?]
agents://.[?]
agents://./subdir[?]
agents://..[?]
agents://../repo[?]
agents://~[?]
agents://~/repo[?]
  • agents:///abs/path: canonical local path query form.
  • agents://. / agents://./subdir: query relative to the current working directory.
  • agents://.. / agents://../repo: query relative to the parent of the current working directory.
  • agents://~ / agents://~/repo: query relative to the home directory.
  • path-scoped query always returns a conversation list.

Agents Query

  • q=: filters discovery results by keyword. Use when you want to find conversations by topic.
  • limit=: limits discovery result count (default 10). Use when you need a shorter or longer result list.
  • providers=: restricts a path-scoped query to selected providers.
  • =: in write mode (-d), xurl forwards as -- to the provider CLI.
  • ``: in write mode (-d), xurl forwards as -- to the provider CLI.

Examples:

agents://codex?q=spawn_agent&limit=10
agents:///Users/alice/work/xurl?q=refactor&providers=codex,claude
agents://.?q=refactor&providers=codex
agents://codex/
agents://codex/reviewer
agents://codex?cd=%2FUsers%2Falice%2Frepo&add-dir=%2FUsers%2Falice%2Fshared

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Rust

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言