> For the complete documentation index, see [llms.txt](https://docs.nimbalyst.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nimbalyst.com/extensions/extension-system-and-marketplace.md).

# Extension System & Marketplace

Install Nimbalyst extensions from a live marketplace registry, build your own extensions to Nimbalyst with a hardened extension SDK. See all the extensions below and make your own.

## What Are Extensions?

Extensions are add-ons that give Nimbalyst new capabilities. Each extension can add custom editors for new file types, AI tools that let your agent interact with your content, sidebar panels, settings pages, themes, keyboard shortcuts, and more.

Extensions work seamlessly alongside Nimbalyst's built-in editors. When you open a file, Nimbalyst checks if any extension handles that file type and loads the right editor automatically. Extensions have full access to Nimbalyst's theming system, so they always match your current look and feel.

## Extensions in the Marketplace

Go to **Settings > Application > Marketplace** to browse and install extensions.

<figure><img src="/files/AZxQKLxo2KfFFWJhJlFp" alt="Extension Marketplace showing featured extensions and category filters"><figcaption><p>The Extension Marketplace in Settings, showing featured extensions, search, and category filters</p></figcaption></figure>

Click any extension card to see its full details, screenshots, permissions, and install button.

<figure><img src="/files/32vwhQ1dXNmWCrRVJ0zy" alt="Extension detail modal showing description, screenshots, and install button"><figcaption><p>Extension detail view with description, highlights, screenshots, and install controls</p></figcaption></figure>

### What's in the catalog

The bundled catalog is updated as extensions are released, so use the Marketplace for the current list, versions, screenshots, and permissions. Recent additions include:

* **Electronics Studio** — work with tscircuit and Circuit JSON in schematic, PCB, assembly, and 3D views; run simulations; and export manufacturing and review artifacts.
* **Replicad CAD** — build parametric 3D models in TypeScript with a live B-rep preview, STEP import and export, geometry inspection, and printability tools.

Marketplace cards show whether an extension is installed and whether an update is available.

### Managing Installed Extensions

View all installed extensions under **Settings > Application > Installed**. This is the single panel for everything you have installed — marketplace, GitHub, local dev, and built-in extensions all show up here, each with a colored source pill so you can tell them apart at a glance.

<figure><img src="/files/5zf0nztGAfSrYotGVxgs" alt="Installed Extensions panel showing all active extensions with details"><figcaption><p>The Installed Extensions panel shows every active extension, its permissions, and contributed AI tools</p></figcaption></figure>

Each row has an enable toggle and an indicator if an update is available. Click an extension to open the detail pane, which includes its AI tools, permissions, file path, and **Update**, **Repository**, **Reveal**, and **Uninstall** actions.

The Marketplace itself is now Discover-only. When updates are available, an "Installed (N) — M updates" link at the top of Marketplace takes you to the Extensions panel.

### Themes from Extensions

Extensions can ship themes. Any theme contributed by an installed extension shows up under **Settings > Application > Themes** in an **Extension Themes** group, and in the gutter theme popup, alongside the built-in themes. Pick one and Nimbalyst applies it just like a first-party theme.

If you later disable or uninstall the extension that provided the active theme, Nimbalyst falls back gracefully so your workspace stays usable.

### Installing from GitHub

At the bottom of the Marketplace discover page, you can paste a GitHub repository URL to install any extension directly from source. The repository must contain a valid `manifest.json` file.

## Build Your Own Extensions

Extensions are self-contained packages that declare their file types, editors, and UI contributions via a manifest. You can build extensions that do everything the built-in ones do.

**What you can build:**

* **Custom editors** for any file type (spreadsheets, diagrams, visual tools)
* **AI tools** that Claude can use to read and modify your editor's content
* **Panels** for sidebar views, fullscreen modes, or floating windows
* **Application or Project settings pages** with project-aware context
* **Project filesystem access** for editors that manage related files
* **Typed tracker item pickers and live references**
* **Themes, slash commands, file icons, and new file templates**

**How development works:**

* The **Extension Dev Kit** (bundled with Nimbalyst) scaffolds a new extension project with a starter template, hot reload, and MCP tools for build/install/reload from inside Nimbalyst
* Editors integrate through the **EditorHost contract** (load/save, dirty state, theme, external change handling) so custom editors behave exactly like first-party ones
* Use the full **Extension SDK** -- clipboard, screenshot export, AI and network permissions, and access to the same MCP tooling that first-party extensions use

For full technical documentation on building extensions, see [Building Your Own Extensions](/extensions/building-extensions.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.nimbalyst.com/extensions/extension-system-and-marketplace.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
