npx rayext install <author>/<repo> [<options>]
npx rayext install <author>/<repo>@<tag> [<options>]

• 📦 Install extensions - directly from any GitHub repository
• 📋 List installed extensions - with version
• 🔍 View extension details - check metadata and info
• 🔄 Update extensions - upgrade via repository tags
• 🗑️ Uninstall extensions - remove from local system

Usage

Install

Install a Raycast extension from a GitHub repository.

npx rayext install <author>/<repo>
npx rayext i <author>/<repo>
npx rayext add <author>/<repo>

Monorepo

[!NOTE] For repositories containing multiple extensions or packages, use the --package option to specify the path to the specific extension package:

npx rayext install <author>/<repo> --package 'packages/extension'

List

Display all installed extensions with their tags or branches.

npx rayext list
npx rayext ls

View

Show detailed information about an installed extension, including metadata and configuration.

npx rayext view <author>/<repo>
npx rayext v <author>/<repo>
npx rayext info <author>/<repo>
npx rayext show <author>/<repo>

Update

Update an installed extension to the latest version available in its repository.

npx rayext update <author>/<repo>
npx rayext upgrade <author>/<repo>
npx rayext up <author>/<repo>

Uninstall

Remove an installed extension from your local file system. You need remove the extension from your Raycast app manually.

npx rayext uninstall <author>/<repo>
npx rayext un <author>/<repo>
npx rayext u <author>/<repo>
npx rayext remove <author>/<repo>
npx rayext rm <author>/<repo>

GitHub Token

GitHub API has rate limits. For high-frequency usage, it's recommended to provide a token parameter or configure the GITHUB_TOKEN environment variable:

# Using token parameter
npx rayext install <author>/<repo> --token <token>

# Or set environment variable
export GITHUB_TOKEN=<token>
npx rayext install <author>/<repo>

Why ?

Raycast extensions must be published to the official repository, which creates challenges:

• All extensions go through one massive repository with thousands of contributors
• Issues and maintenance become difficult to track
• Developers lose control over their extension lifecycle
• Slow centralized review process

rayext provides a decentralized alternative - install extensions directly from any GitHub repository, giving developers full control and users direct access to more extensions.

License

MIT License © jinghaihan