--- name: byr-cli description: Use BYR CLI for auth, search, detail inspection, and safe torrent download planning with JSON envelopes. metadata: { "openclaw": { "skillKey": "byr-cli", "homepage": "https://clawhub.ai", "requires": { "bins": ["byr"] }, "install": [ { "id": "brew", "kind": "brew", "formula": "byr-pt-cli", "tap": "1MoreBuild/tap", "bins": ["byr"], "label": "Install byr CLI (Homebrew)", }, { "id": "node", "kind": "node", "package": "byr-pt-cli", "bins": ["byr"], "label": "Install byr CLI (npm fallback)", }, ], }, } ---

BYR CLI Skill

When To Use

Use this skill when a task needs any BYR operation via CLI:

• authenticate/check auth state
• search torrents with filters
• browse latest torrents with filters
• inspect torrent details
• plan or execute torrent downloads
• fetch BYR metadata and user info
• run local diagnostics before live calls

Boundaries

• Work only through the byr binary.
• Prefer --json for machine-readable output.
• Do not infer missing IDs/paths or silently mutate files.
• Keep read-only commands non-destructive.

Auth Notes

• Support both cookie formats in auth import-cookie:

- uid=...; pass=... - session_id=...; auth_token=... (optional refresh_token=...)

• Browser import:

- chrome (macOS path/decrypt flow) - safari best effort with manual fallback

• Always check status before live operations:

- byr auth status --verify --json

Commands (JSON First)

Read-only:

• byr check --json
• byr whoami --json
• byr doctor [--verify] --json
• byr browse [--limit ] [--category ] [--incldead ] [--spstate ] [--bookmarked ] [--page ] --json
• byr search --query "" --limit --json
• byr search --imdb [--category ] [--spstate ] --json
• byr get --id --json
• byr user info --json
• byr meta categories --json
• byr meta levels --json
• byr auth status [--verify] --json
• byr auth import-cookie --cookie "" --json
• byr auth import-cookie --from-browser [--profile ] --json
• byr auth logout --json

Write side effect:

• Dry run first: byr download --id --output --dry-run --json
• Actual write: byr download --id --output --json

Search/Browse Semantics

• search and browse return paged list data.
• JSON fields:

- matchedTotal: estimated total hits inferred from BYR pagination range blocks. - returned: number of items returned in current payload. - total: backward-compatible alias of returned.

• If --page is omitted, list commands auto-fetch subsequent pages until --limit is reached.
• If --page is provided, only that page is fetched.

Side-Effect Policy

Before non-dry-run download:

1. verify --id and --output are explicit
2. run dry-run and inspect sourceUrl/fileName
3. confirm intent for the output path

If parameters are missing, ask for explicit values.

Error handling

• Surface error.code and error.message.
• For E_ARG_*: request corrected flags/arguments.
• For E_AUTH_*: re-auth guidance (auth import-cookie or credential refresh).
• For E_NOT_FOUND_*: request different query/torrent ID.
• For E_UPSTREAM_*: suggest retry and capture command/context.

Response Style

• Keep result summaries short.
• Include key fields for search/get: id, title, size, seeders, leechers.
• For list commands include both matchedTotal and returned when present.
• Include key fields for download: outputPath, sourceUrl, dryRun, bytesWritten.