SkyStream CLI

The official command-line toolkit for deploying, testing, and managing SkyStream (Gen 2) plugin repositories.

🚀 Quick Start

Installation

npm install -g skystream-cli

Initialize a new Repository

skystream init "My Universe" --package-name com.example.repo --plugin-name "Provider 1"

Add a new Plugin

cd my-universe
skystream add "New Provider"

Deploy for Distribution

skystream deploy -u https://my-cdn.com/repo

🛠 Commands

init

Initialize a new Sky Gen 2 Repository project.

Usage:

skystream init <project-name> --package-name <id> --plugin-name <name> [options]

Options:

• -p, --package-name <id>: (Required) Unique Repository ID (e.g., com.dev.stars).
• -n, --plugin-name <name>: (Required) First plugin name (e.g., YTS).
• -d, --description <desc>: Repository description (Default: SkyStream plugins repository).
• -a, --author <author>: Author name (Default: Developer).

add

Add a new Sky Gen 2 plugin to an existing repository.

Usage:

skystream add <plugin-name> [options]

Options:

• -d, --description <desc>: Plugin description.
• -a, --author <author>: Author name.

validate

Validate all plugins in the repository (manifests and logic exports).

Usage:

skystream validate

test

Test a specific plugin in a mock runtime.

Usage:

skystream test [options]

Options:

• -p, --path <path>: Path to plugin folder (Default: .).
• -f, --function <name>: Function to test (Default: getHome).
• -q, --query <query>: Query string (URLs for load/loadStreams, keywords for search).

Examples:

# Test dashboard categories
skystream test -f getHome

# Test search with a keyword
skystream test -f search -q "avatar"

# Test full details for a movie/series
skystream test -f load -q "https://site.com/movie/123"

# Test stream links extraction
skystream test -f loadStreams -q "https://site.com/movie/123"

deploy

Bundle all plugins and generate the repo.json index.

Usage:

skystream deploy --url <url>

Options:

• -u, --url <url>: (Required) Base hosting URL where the .sky files will be served (e.g., https://raw.githubusercontent.com/USER/REPO/main).

📖 Learn More

Visit the SkyStream Repository Specification for more details.