byr-cli

What This Skill Does

The byr-cli skill provides a standardized, machine-readable interface for interacting with the BYR torrent platform. By leveraging the byr binary, the agent can perform deep inspections of content, manage user authentication, search for specific media via metadata or IMDb identifiers, and safely execute download tasks. It is designed to act as a bridge between the OpenClaw agent and the BYR ecosystem, utilizing JSON output for all operations to ensure maximum reliability and integration with other agent workflows.

Installation

To integrate this skill into your environment, run the following command: clawhub install openclaw/skills/skills/1morebuild/byr-cli

Use Cases

This skill is ideal for automating content curation and acquisition tasks. Use it when you need to:

• Authenticate: Securely import browser cookies or set up session tokens for persistent access.
• Search and Discover: Use specific filters like categories, upload status, or bookmark states to query the latest torrents.
• Inspect Media: Fetch detailed torrent metadata, including file lists and source information, before committing to a download.
• Manage Downloads: Execute staged, safe downloads by using the mandatory dry-run feature to verify output paths and filenames before any write operations occur.
• System Health: Perform diagnostic checks to ensure the connection to the BYR API is stable and credentials are valid.

Example Prompts

1. "Search for the movie with IMDb id tt1234567 and tell me what audio formats are available."
2. "Check my current BYR auth status, and if it's expired, help me import my Chrome cookies."
3. "List the top 5 most recent high-definition movies in the animation category, then prepare a download for the first one to my /downloads/movies folder."

Tips & Limitations

• Safety First: Always perform a dry-run with the download command. This ensures the agent does not write files to incorrect paths and allows you to confirm the destination before the CLI writes data.
• JSON Mode: This skill relies heavily on --json flags. Avoid running commands without these flags as the agent expects structured data to correctly process outcomes.
• Pagination: Note that list operations like browse and search default to auto-fetching pages until a limit is met. If you need specific results, be explicit with your --limit to conserve bandwidth and processing time.
• Auth State: Always run byr auth status --verify at the start of a session. It is the most efficient way to diagnose upstream connection issues before attempting intensive tasks.