How do I install the X Callback Urlxcall skill?

Run npx skillmds@latest add tomevault-io/x-callback-urlxcall in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is X Callback Urlxcall safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with X Callback Urlxcall?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is X Callback Urlxcall free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published X Callback Urlxcall?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

X Callback Urlxcall by tomevault-io

Name: X Callback Urlxcall
Author: tomevault-io

X Callback Urlxcall

Call x-callback-url schemes from the CLI and receive responses synchronously. Use when invoking macOS app URL schemes that have no CLI but support x-callback-url (Things, Bear, OmniFocus, etc.) and you need to capture the result. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

xcall

Send x-callback-url requests from the command line and receive responses synchronously.

How It Works

xcall is a Swift CLI that builds into a macOS .app bundle. The .app is required because macOS only delivers URL scheme callbacks to registered applications. On first use, run.sh compiles the source and registers the callback scheme (xcall-claude://) with Launch Services.

Usage

${CLAUDE_PLUGIN_ROOT}/scripts/run.sh "<url>"

stdout: x-success query string on success stderr: x-error query string or timeout message Exit codes: 0 = success, 1 = error, 2 = cancel

Examples

Things 3

# Add a todo, get its ID back
${CLAUDE_PLUGIN_ROOT}/scripts/run.sh "things:///add?title=Buy%20milk"
# stdout: x-things-id=ABC123

# Update a todo, confirm it applied
${CLAUDE_PLUGIN_ROOT}/scripts/run.sh "things:///update?id=ABC123&auth-token=TOKEN&completed=true"
# stdout: x-things-id=ABC123

# Batch create via JSON
${CLAUDE_PLUGIN_ROOT}/scripts/run.sh "things:///json?data=..."
# stdout: x-things-ids=["ABC123","DEF456"]

Bear

# Create a note and get its ID
${CLAUDE_PLUGIN_ROOT}/scripts/run.sh "bear://x-callback-url/create?title=Meeting%20Notes&text=..."
# stdout: identifier=ABC-123&title=Meeting%20Notes

x-callback-url Protocol

The x-callback-url protocol defines three callback parameters:

x-success — called on success, with app-specific result parameters
x-error — called on failure, with errorCode and errorMessage
x-cancel — called when the user cancels

xcall appends these automatically using its registered xcall-claude:// scheme.

Supported Apps

Any macOS app that supports x-callback-url and lacks a CLI:

Things 3 — returns x-things-id / x-things-ids
Bear — returns note identifiers
OmniFocus — returns task IDs
Drafts — returns draft UUIDs

Apps with their own CLI (e.g., Shortcuts via shortcuts run) don't need xcall — use the CLI directly.

Build Details

Source: scripts/main.swift (~100 lines)
Build: scripts/build.sh compiles to scripts/xcall.app/
Bundle ID: com.bendrucker.xcall-claude
Callback scheme: xcall-claude://
Info.plist: CFBundleTypeRole=Editor, LSUIElement=true, LSBackgroundOnly=true
Build is cached — only recompiles if main.swift is newer than the binary
Timeout: 10 seconds

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: x-callback-urlxcalldescription: Call x-callback-url schemes from the CLI and receive responses synchronously. Use when invoking macOS app URL schemes that have no CLI but support x-callback-url (Things, Bear, OmniFocus, etc.) and you need to capture the result. Use when this capability is needed.---# xcallSend [x-callback-url](https://x-callback-url.com/) requests from the command line and receive responses synchronously.## How It Works`xcall` is a Swift CLI that builds into a macOS `.app` bundle. The `.app` is required because macOS only delivers URL scheme callbacks to registered applications. On first use, `run.sh` compiles the source and registers the callback scheme (`xcall-claude://`) with Launch Services.## Usage```bash${CLAUDE_PLUGIN_ROOT}/scripts/run.sh "<url>"```**stdout**: `x-success` query string on success**stderr**: `x-error` query string or timeout message**Exit codes**: 0 = success, 1 = error, 2 = cancel## Examples### Things 3```bash# Add a todo, get its ID back${CLAUDE_PLUGIN_ROOT}/scripts/run.sh "things:///add?title=Buy%20milk"# stdout: x-things-id=ABC123# Update a todo, confirm it applied${CLAUDE_PLUGIN_ROOT}/scripts/run.sh "things:///update?id=ABC123&auth-token=TOKEN&completed=true"# stdout: x-things-id=ABC123# Batch create via JSON${CLAUDE_PLUGIN_ROOT}/scripts/run.sh "things:///json?data=..."# stdout: x-things-ids=["ABC123","DEF456"]```### Bear```bash# Create a note and get its ID${CLAUDE_PLUGIN_ROOT}/scripts/run.sh "bear://x-callback-url/create?title=Meeting%20Notes&text=..."# stdout: identifier=ABC-123&title=Meeting%20Notes```## x-callback-url ProtocolThe [x-callback-url](https://x-callback-url.com/specification/) protocol defines three callback parameters:- **x-success** — called on success, with app-specific result parameters- **x-error** — called on failure, with `errorCode` and `errorMessage`- **x-cancel** — called when the user cancels`xcall` appends these automatically using its registered `xcall-claude://` scheme.## Supported AppsAny macOS app that supports `x-callback-url` and lacks a CLI:- [Things 3](https://culturedcode.com/things/support/articles/2803573/) — returns `x-things-id` / `x-things-ids`- [Bear](https://bear.app/faq/x-callback-url-scheme-documentation/) — returns note identifiers- [OmniFocus](https://inside.omnifocus.com/url-schemes) — returns task IDs- [Drafts](https://docs.getdrafts.com/docs/automation/urlschemes) — returns draft UUIDsApps with their own CLI (e.g., Shortcuts via `shortcuts run`) don't need xcall — use the CLI directly.## Build Details- Source: `scripts/main.swift` (~100 lines)- Build: `scripts/build.sh` compiles to `scripts/xcall.app/`- Bundle ID: `com.bendrucker.xcall-claude`- Callback scheme: `xcall-claude://`- `Info.plist`: `CFBundleTypeRole=Editor`, `LSUIElement=true`, `LSBackgroundOnly=true`- Build is cached — only recompiles if `main.swift` is newer than the binary- Timeout: 10 seconds---> Converted and distributed by [TomeVault](https://tomevault.io/claim/bendrucker) — claim your Tome and manage your conversions.

Frequently asked questions