@xuanwo/xurl 0.0.24 → 0.0.26-darwin-x64

package/README.md

@@ -1,66 +1,90 @@
 # xURL
 
-`xURL` is a client for AI agent URLs.
+`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
 
-- Read an agent conversation as markdown.
-- Query recent threads and keyword matches for a provider.
-- Query conversations by local path across providers.
-- Query role-scoped threads with `agents://<provider>/<role>`.
-- Discover subagent/branch navigation targets.
-- Start a new conversation with agents.
-- Continue an existing conversation with follow-up prompts.
+xURL gives you one URI scheme (`agents://`) to **read**, **query**, **discover**, and **write** conversations across multiple AI agent CLIs.
 
-## Quick Start
+- **Read** a conversation as markdown — `xurl agents://codex/<id>`
+- **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/<id>`
+- **Write** to start or continue a conversation — `xurl agents://codex -d "hello"`
+
+## Providers
 
-1. Add `xurl` as an agent skill:
+<table>
+  <tr>
+    <td align="center"><img src="https://ampcode.com/amp-mark-color.svg" alt="Amp" width="36" height="36" /><br /><code>agents://amp</code></td>
+    <td align="center"><img src="https://cdn.simpleicons.org/claude" alt="Claude" width="36" height="36" /><br /><code>agents://claude</code></td>
+    <td align="center"><img src="https://avatars.githubusercontent.com/u/14957082?s=200&v=4" alt="Codex" width="36" height="36" /><br /><code>agents://codex</code></td>
+    <td align="center"><img src="https://cdn.simpleicons.org/githubcopilot" alt="GitHub Copilot" width="36" height="36" /><br /><code>agents://copilot</code></td>
+    <td align="center"><img src="https://www.cursor.com/favicon.ico" alt="Cursor" width="36" height="36" /><br /><code>agents://cursor</code></td>
+  </tr>
+  <tr>
+    <td align="center"><img src="https://cdn.simpleicons.org/googlegemini" alt="Gemini" width="36" height="36" /><br /><code>agents://gemini</code></td>
+    <td align="center"><img src="https://avatars.githubusercontent.com/u/129152888?s=200&v=4" alt="Kimi" width="36" height="36" /><br /><code>agents://kimi</code></td>
+    <td align="center"><img src="https://avatars.githubusercontent.com/u/208539476?s=200&v=4" alt="OpenCode" width="36" height="36" /><br /><code>agents://opencode</code></td>
+    <td align="center"><img src=".github/assets/pi-logo-dark.svg" alt="Pi" width="36" height="36" /><br /><code>agents://pi</code></td>
+  </tr>
+</table>
+
+## Installation
+
+Install as an agent skill:
 
 ```bash
 npx skills add Xuanwo/xurl
 ```
 
-2. Start your agent and ask the agent to summarize a thread:
+Or install the standalone CLI:
 
-```text
-Please summarize this thread: agents://codex/xxx_thread
+```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
 ```
 
-## Providers
+## Quick Start
+
+Ask your agent to summarize a thread:
 
-| Provider | Query | Create | Role Create |
-| --- | --- | --- | --- |
-| <img src="https://ampcode.com/amp-mark-color.svg" alt="Amp logo" width="16" height="16" /> Amp | Yes | Yes | No |
-| <img src="https://avatars.githubusercontent.com/u/14957082?s=24&v=4" alt="Codex logo" width="16" height="16" /> Codex | Yes | Yes | Yes |
-| <img src="https://www.anthropic.com/favicon.ico" alt="Claude logo" width="16" height="16" /> Claude | Yes | Yes | Yes |
-| <img src="https://www.google.com/favicon.ico" alt="Gemini logo" width="16" height="16" /> Gemini | Yes | Yes | No |
-| <img src=".github/assets/pi-logo-dark.svg" alt="Pi logo" width="16" height="16" /> Pi | Yes | Yes | No |
-| <img src="https://opencode.ai/favicon.ico" alt="OpenCode logo" width="16" height="16" /> OpenCode | Yes | Yes | Yes |
+```text
+Please summarize this thread: agents://codex/xxx_thread
+```
 
 ## Usage
 
-Read an agent conversation:
+> **Note:** The `agents://` scheme prefix is optional — `codex/...` is equivalent to `agents://codex/...`.
+
+### Read
 
 ```bash
 xurl agents://codex/019c871c-b1f9-7f60-9c4f-87ed09f13592
-# equivalent shorthand:
-xurl codex/019c871c-b1f9-7f60-9c4f-87ed09f13592
+xurl agents://copilot/688628a1-407a-4b4e-b24a-1a250ebf864f
 ```
 
-Query provider threads:
+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'
-# equivalent shorthand:
-xurl codex
-xurl 'codex?q=spawn_agent'
+xurl 'agents://copilot?q=resume&limit=5'
 ```
 
-Query conversations by path:
+By local path:
 
 ```bash
 xurl agents:///Users/alice/work/xurl
@@ -69,23 +93,21 @@ xurl 'agents://.?q=refactor&providers=codex,claude'
 xurl 'agents://~/work/xurl?providers=opencode'
 ```
 
-Query role-scoped threads:
+By role:
 
 ```bash
 xurl agents://codex/reviewer
-# equivalent shorthand:
-xurl codex/reviewer
 ```
 
-Query results include the same reduced thread metadata used by `--head` when it is available, so you can inspect fields like `payload.git.branch` without opening each thread individually.
+Query results include reduced thread metadata when available, so you can inspect fields like `payload.git.branch` without opening each thread individually.
 
-Discover child targets:
+### Discover
 
 ```bash
 xurl -I agents://codex/019c871c-b1f9-7f60-9c4f-87ed09f13592
 ```
 
-Frontmatter includes the first provider metadata record flattened into readable key-value lines such as `payload.git.branch = ...`, and skips oversized instruction-like fields.
+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:
 
@@ -93,18 +115,19 @@ Drill down into a discovered child target:
 xurl agents://codex/019c871c-b1f9-7f60-9c4f-87ed09f13592/019c87fb-38b9-7843-92b1-832f02598495
 ```
 
-Start a new agent conversation:
+### Write
+
+Start a new conversation:
 
 ```bash
 xurl agents://codex -d "Draft a migration plan"
-# equivalent shorthand:
-xurl codex -d "Draft a migration plan"
 ```
 
-Start a new conversation with role URI:
+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:
@@ -113,18 +136,12 @@ Continue an existing conversation:
 xurl agents://codex/019c871c-b1f9-7f60-9c4f-87ed09f13592 -d "Continue"
 ```
 
-Create with query parameters:
+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"
 ```
 
-Save output:
-
-```bash
-xurl -o /tmp/conversation.md agents://codex/019c871c-b1f9-7f60-9c4f-87ed09f13592
-```
-
 ## Command Reference
 
 ```bash
@@ -150,7 +167,7 @@ xurl [OPTIONS] <URI>
 ```
 
 - `scheme`: optional `agents://` prefix. If omitted, `xurl` treats input as an `agents` URI shorthand.
-- `provider`: target provider name, such as `codex`, `claude`, `gemini`, `amp`, `pi`, `opencode`.
+- `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.
@@ -187,7 +204,7 @@ 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/threads/<conversation_id>
+agents://codex/<conversation_id>
 agents://codex/reviewer
 agents://codex?cd=%2FUsers%2Falice%2Frepo&add-dir=%2FUsers%2Falice%2Fshared
 ```

package/package.json

@@ -1,27 +1,21 @@
 {
   "name": "@xuanwo/xurl",
-  "version": "0.0.24",
+  "version": "0.0.26-darwin-x64",
   "license": "Apache-2.0",
-  "bin": {
-    "xurl": "bin/xurl.js"
-  },
-  "type": "module",
-  "engines": {
-    "node": ">=16"
-  },
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "x64"
+  ],
   "files": [
-    "bin"
+    "vendor"
   ],
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Xuanwo/xurl.git"
   },
-  "optionalDependencies": {
-    "@xuanwo/xurl-linux-x64": "npm:@xuanwo/xurl@0.0.24-linux-x64",
-    "@xuanwo/xurl-linux-arm64": "npm:@xuanwo/xurl@0.0.24-linux-arm64",
-    "@xuanwo/xurl-darwin-x64": "npm:@xuanwo/xurl@0.0.24-darwin-x64",
-    "@xuanwo/xurl-darwin-arm64": "npm:@xuanwo/xurl@0.0.24-darwin-arm64",
-    "@xuanwo/xurl-win32-x64": "npm:@xuanwo/xurl@0.0.24-win32-x64",
-    "@xuanwo/xurl-win32-arm64": "npm:@xuanwo/xurl@0.0.24-win32-arm64"
+  "engines": {
+    "node": ">=16"
   }
 }

package/bin/xurl.js

@@ -1,141 +0,0 @@
-#!/usr/bin/env node
-// Unified entry point for the xurl CLI.
-
-import { spawn } from "node:child_process";
-import { existsSync } from "node:fs";
-import { createRequire } from "node:module";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const require = createRequire(import.meta.url);
-
-const PLATFORM_PACKAGE_BY_TARGET = {
-  "x86_64-unknown-linux-gnu": "@xuanwo/xurl-linux-x64",
-  "aarch64-unknown-linux-gnu": "@xuanwo/xurl-linux-arm64",
-  "x86_64-apple-darwin": "@xuanwo/xurl-darwin-x64",
-  "aarch64-apple-darwin": "@xuanwo/xurl-darwin-arm64",
-  "x86_64-pc-windows-msvc": "@xuanwo/xurl-win32-x64",
-  "aarch64-pc-windows-msvc": "@xuanwo/xurl-win32-arm64",
-};
-
-function detectTargetTriple(platformName, archName) {
-  switch (platformName) {
-    case "linux":
-      if (archName === "x64") {
-        return "x86_64-unknown-linux-gnu";
-      }
-      if (archName === "arm64") {
-        return "aarch64-unknown-linux-gnu";
-      }
-      break;
-    case "darwin":
-      if (archName === "x64") {
-        return "x86_64-apple-darwin";
-      }
-      if (archName === "arm64") {
-        return "aarch64-apple-darwin";
-      }
-      break;
-    case "win32":
-      if (archName === "x64") {
-        return "x86_64-pc-windows-msvc";
-      }
-      if (archName === "arm64") {
-        return "aarch64-pc-windows-msvc";
-      }
-      break;
-    default:
-      break;
-  }
-  return null;
-}
-
-function detectPackageManager() {
-  const userAgent = process.env.npm_config_user_agent || "";
-  if (/\bbun\//.test(userAgent)) {
-    return "bun";
-  }
-  return userAgent ? "npm" : null;
-}
-
-const targetTriple = detectTargetTriple(process.platform, process.arch);
-if (!targetTriple) {
-  throw new Error(`Unsupported platform: ${process.platform} (${process.arch})`);
-}
-
-const platformPackage = PLATFORM_PACKAGE_BY_TARGET[targetTriple];
-if (!platformPackage) {
-  throw new Error(`Unsupported target triple: ${targetTriple}`);
-}
-
-const binaryName = process.platform === "win32" ? "xurl.exe" : "xurl";
-const localVendorRoot = path.join(__dirname, "..", "vendor");
-const localBinaryPath = path.join(localVendorRoot, targetTriple, "xurl", binaryName);
-
-let vendorRoot;
-try {
-  const packageJsonPath = require.resolve(`${platformPackage}/package.json`);
-  vendorRoot = path.join(path.dirname(packageJsonPath), "vendor");
-} catch {
-  if (existsSync(localBinaryPath)) {
-    vendorRoot = localVendorRoot;
-  } else {
-    const manager = detectPackageManager();
-    const updateCommand =
-      manager === "bun"
-        ? "bun install -g @xuanwo/xurl@latest"
-        : "npm install -g @xuanwo/xurl@latest";
-    throw new Error(
-      `Missing optional dependency ${platformPackage}. Reinstall xurl: ${updateCommand}`,
-    );
-  }
-}
-
-const binaryPath = path.join(vendorRoot, targetTriple, "xurl", binaryName);
-const env = { ...process.env };
-env[detectPackageManager() === "bun" ? "XURL_MANAGED_BY_BUN" : "XURL_MANAGED_BY_NPM"] =
-  "1";
-
-const child = spawn(binaryPath, process.argv.slice(2), {
-  stdio: "inherit",
-  env,
-});
-
-child.on("error", (err) => {
-  // eslint-disable-next-line no-console
-  console.error(err);
-  process.exit(1);
-});
-
-const forwardSignal = (signal) => {
-  if (child.killed) {
-    return;
-  }
-  try {
-    child.kill(signal);
-  } catch {
-    // Ignore errors when the child already exited.
-  }
-};
-
-["SIGINT", "SIGTERM", "SIGHUP"].forEach((signal) => {
-  process.on(signal, () => forwardSignal(signal));
-});
-
-const childResult = await new Promise((resolve) => {
-  child.on("exit", (code, signal) => {
-    if (signal) {
-      resolve({ type: "signal", signal });
-    } else {
-      resolve({ type: "code", exitCode: code ?? 1 });
-    }
-  });
-});
-
-if (childResult.type === "signal") {
-  process.kill(process.pid, childResult.signal);
-} else {
-  process.exit(childResult.exitCode);
-}