Create Your First Extension

Learn how to build your first extension and use it in Raycast.

Create a new extension

Open the Create Extension command, name your extension "Hello World" and select the "Detail" template. Pick a parent folder in the Location field and press ⌘ ↵ to continue.

Create Extension command in Raycast

To create a private extension, select your organization in the first dropdown. You need to be logged in and part of an organization to see the dropdown. Learn more about Raycast for Teams here.

Next, you'll need to follow the on-screen instructions to build the extension.

Build the extension

Open your terminal, navigate to your extension directory and run npm install && npm run dev. Open Raycast, and you'll notice your extension at the top of the root search. Press ↵ to open it.

Your first extension

Develop your extension

To make changes to your extension, open the ./src/index.tsx file in your extension directory, change the markdown text and save it. Then, open your command in Raycast again and see your changes.

npm run dev starts the extension in development mode with hot reloading, error reporting and more.

Use your extension

Now, you can press ⌃ C in your terminal to stop npm run dev. The extension stays in Raycast, and you can find its commands in the root when searching for the extension name "Hello World" or the command name "Render Markdown".

Find your extension in the root search

🎉 Congratulations! You built your first extension. Off to many more.

Don't forget to run npm run dev again when you want to change something in your extension.