Skill

x-callback-url:xcall

Invoke x-callback-url schemes from macOS CLI to call apps like Things, Bear, OmniFocus and capture synchronous responses via registered Swift app bundle.

Swift

Bash

cli-tools

automation

Install

npx claudepluginhub bendrucker/claude --plugin x-callback-url

Tool Access

This skill is limited to using the following tools:

BashRead

Preview

Send [x-callback-url](https://x-callback-url.com/) requests from the command line and receive responses synchronously.

SKILL.md

Similar Skills

cache-components

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

139.2k

mcp-builder

9 files

Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).

anthropics-skills-13

124.2k

canvas-design

20 files

Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.

anthropics-skills-13

124.2k

Stats

Parent Repo Stars10

Parent Repo Forks1

Last CommitMar 9, 2026

Actions

View Source View Plugin View on GitHub View README

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