rayext

A decentralized extension manager for Raycast that pulls directly from Github repositories

[![npm version][npm-version-src]][npm-version-href]
[![bundle][bundle-src]][bundle-href]
[![JSDocs][jsdocs-src]][jsdocs-href]
[![License][license-src]][license-href]

``sh
npx rayext install / []
npx rayext install /@ []
`

- 📦 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

$3

Install a Raycast extension from a GitHub repository.

`sh
npx rayext install /
npx rayext i /
npx rayext add /
`

#### Monorepo

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

`sh
npx rayext install / --package 'packages/extension'
`

$3

Display all installed extensions with their tags or branches.

`sh
npx rayext list
npx rayext ls
`

$3

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

`sh
npx rayext view /
npx rayext v /
npx rayext info /
npx rayext show /
`

$3

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

`sh
npx rayext update /
npx rayext upgrade /
npx rayext up /
`

$3

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

`sh
npx rayext uninstall /
npx rayext un /
npx rayext u /
npx rayext remove /
npx rayext rm /
`

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:

`sh


Using token parameter

npx rayext install / --token

Or set environment variable

export GITHUB_TOKEN=
npx rayext install /
`

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

[npm-version-src]: https://img.shields.io/npm/v/rayext?style=flat&colorA=080f12&colorB=1fa669
[npm-version-href]: https://npmjs.com/package/rayext
[npm-downloads-src]: https://img.shields.io/npm/dm/rayext?style=flat&colorA=080f12&colorB=1fa669
[npm-downloads-href]: https://npmjs.com/package/rayext
[bundle-src]: https://img.shields.io/bundlephobia/minzip/rayext?style=flat&colorA=080f12&colorB=1fa669&label=minzip
[bundle-href]: https://bundlephobia.com/result?p=rayext
[license-src]: https://img.shields.io/badge/license-MIT-blue.svg?style=flat&colorA=080f12&colorB=1fa669
[license-href]: https://github.com/jinghaihan/rayext/LICENSE
[jsdocs-src]: https://img.shields.io/badge/jsdocs-reference-080f12?style=flat&colorA=080f12&colorB=1fa669
[jsdocs-href]: https://www.jsdocs.io/package/rayext