> For the complete documentation index, see [llms.txt](https://docs.kira.thiennguyen.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kira.thiennguyen.dev/user-guide/extensions-using.md).

# Using Extensions

Extensions add **action buttons** to a global **Extensions** section in Kira. Each button runs a small script that can do useful things — fire a deploy webhook, generate a report, run a routine task — using your account context and secrets.

This page is about **installing and running** extensions. If you want to *build* one, see [Extension Development](/extension-development/overview.md).

## Where to find them

Open the **Extensions** section from the account-picker home, or via [Spotlight](/user-guide/navigation.md#spotlight-command-palette) → "Extensions".

## Installing an extension

Extensions are distributed as `.kext` bundles. Install one in two ways:

* **From a file** — **Install extension → Choose file…** and pick a `.kext`.
* **From a URL** — paste an `https` link to a `.kext`; Kira downloads it.

### The trust gate

{% hint style="warning" %}
An extension runs **arbitrary code with your user privileges** (filesystem, network, processes). Before installing, Kira shows you the extension's **source code** and asks you to confirm **once**. Only install extensions you trust — and be especially careful with extensions imported from a URL.
{% endhint %}

## Running an action

Click an action button to run it. Depending on how the extension is written, it may:

* **Prompt for an account** the first time (with a "Save for next run" option), if the action needs AWS access and no account is pre-set.
* **Ask you for input** or **confirmation** mid-run via dialogs.
* **Show a report** or pop **toast** notifications.

## The Output console

Each run streams its progress to an **Output console** — log lines, status, and how long it took. A failed run shows the error in red. You can cancel a run from the console; closing the console doesn't stop the run, and you can reopen it from the **Output** button in the Extensions header.

## Configuring an extension

Use an extension's **Configure** (gear) dialog to override its account/role/region per action — handy when the same extension should target different accounts.

## Compatibility

An extension may declare a minimum Kira version. If your Kira is older, the extension still installs but its actions are **disabled** and marked with a `Kira ≥ X` badge until you update.


---

# 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.kira.thiennguyen.dev/user-guide/extensions-using.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.