> 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/readme.md).

# Introduction

**Kira** is a native macOS desktop app that puts your day-to-day AWS work behind one fast, keyboard-driven window. Instead of juggling the AWS console, the CLI, and a separate database client, you log in once with AWS SSO and browse, query, and operate your infrastructure across every account from a single place.

Home page & downloads: [kira.thiennguyen.dev](https://kira.thiennguyen.dev)

## What you can do

| Area                | Highlights                                                                                                                                                                                                      |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **ECS**             | Browse clusters, services and tasks; redeploy, scale and roll back services; view task definitions and revisions; watch service metrics and health; open an interactive shell inside a running task (ECS Exec). |
| **Databases**       | Browse RDS instances and run SQL; query and scan DynamoDB tables; connect to your own PostgreSQL / MySQL / Redshift servers; open secure SSH tunnels; store credentials in the macOS Keychain.                  |
| **S3**              | Navigate buckets and prefixes; preview, upload, download, copy, rename and delete objects; create folders.                                                                                                      |
| **Secrets Manager** | List secrets and fetch values for the active account.                                                                                                                                                           |
| **CloudWatch Logs** | Tail and search log streams.                                                                                                                                                                                    |
| **Smart Query**     | Optional AI-assisted SQL generation powered by the `claude` CLI.                                                                                                                                                |
| **Extensions**      | Install `.kext` bundles that add custom action buttons backed by small Go scripts.                                                                                                                              |

Kira also gives you a global summon hotkey, a `Cmd+K` command palette (Spotlight), and `kira://` deep links so you can jump straight to a resource.

## How it fits together

```mermaid
flowchart LR
    User([You]) --> Kira[Kira<br/>macOS app]
    Kira -->|AWS SSO login| SSO[AWS IAM Identity Center]
    Kira --> ECS[ECS]
    Kira --> RDS[RDS]
    Kira --> DDB[DynamoDB]
    Kira --> S3[S3]
    Kira --> SM[Secrets Manager]
    Kira --> CW[CloudWatch Logs]
    Kira -.optional.-> Local[(Your own<br/>SQL servers)]
    Kira -.optional.-> AI[claude CLI<br/>Smart Query]
```

Kira talks to AWS directly from your machine using your own SSO credentials — there is no Kira-hosted backend in the path. Secret values, query results and row data stay local except where you explicitly send them somewhere.

## Platform

Kira is **macOS only**. It is distributed as a signed `.dmg` (or shared internally as an unsigned build) from [kira.thiennguyen.dev](https://kira.thiennguyen.dev). See [Installation](/getting-started/installation.md) to get started.

## Where to go next

* New to Kira? Start with [Installation](/getting-started/installation.md), then [SSO & First Login](/getting-started/sso-login.md).
* Tuning behaviour? See the [Configuration](/getting-started/configuration.md) reference.
* Building automation? Jump to [Extension Development](/extension-development/overview.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.kira.thiennguyen.dev/readme.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.