xurl
Unified CLI tool to read, query, discover, and write AI agent conversations using the agents:// URI scheme across multiple coding agents and providers.
Introduction
xURL is a powerful CLI utility that streamlines cross-agent workflows by providing a standardized URI scheme (agents://) for interacting with AI agent conversations. Whether you are using tools like Claude, Codex, Copilot, Cursor, or others, xURL enables a unified interface to retrieve, summarize, compare, or continue threads regardless of the specific provider. This tool is designed for developers who juggle multiple AI assistants and need to maintain context across different coding sessions, projects, or agent-based tasks.
-
Perform comprehensive queries across provider history, local paths, or specific roles using keyword filters and search parameters.
-
Seamlessly read conversation timelines, outputting detailed markdown representations with YAML frontmatter for metadata inspection.
-
Discover subagent interactions and conversation metadata using deep-inspection modes to trace project evolution.
-
Execute write operations to spawn new conversations or extend existing threads by piping data directly from files or standard input.
-
Extract meaningful insights by comparing suggestions from different models or finding specific historical fixes across your entire agent-assisted project history.
-
The tool requires a provider and conversation identifier or search query to construct valid URIs, such as agents://codex/<id>.
-
Use the -I flag for head-only inspection to efficiently browse metadata before loading full transcripts.
-
Supports piping and redirection, allowing developers to automate prompt management by sourcing inputs from local markdown files or standard streams.
-
Provides actionable error messages and suggestions for missing data, ensuring developers know exactly what information or provider authorization is required to proceed.
-
Designed for command-line efficiency, supporting cross-platform installation via Homebrew, Cargo, uv, and npm to fit seamlessly into any development environment.
Repository Stats
- Stars
- 320
- Forks
- 27
- Open Issues
- 5
- Language
- Rust
- Default Branch
- main
- Sync Status
- Idle
- Last Synced
- May 3, 2026, 03:54 PM