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

# Navigating Kira

Kira is built for keyboard-driven, multi-account work. A few app-wide controls let you move fast no matter which screen you're on.

## Account picker

Pick the **account** and **role** you want to operate as. Everything you do — listing services, running queries, reading secrets — happens in that account/role/region context. Kira remembers your last selection and lets you switch at any time. Accounts can be tagged with an environment label (see [SSO & First Login](/getting-started/sso-login.md#environment-tagging)) so production stands out from staging.

## Spotlight (command palette)

Press **`Cmd+K`** (or `Ctrl+K`) to open Spotlight — a fuzzy command palette for jumping to resources and actions without clicking through menus. Use it to find ECS services, S3 buckets, secrets, DynamoDB tables, extensions, and navigation commands. Kira keeps a list of your recents so frequent destinations surface first.

## Global summon hotkey

Kira registers a system-wide hotkey so you can bring it to the foreground from anywhere, even when it's hidden. The default is **`Ctrl+Shift+K`**. You can change it (or disable it) via the `globalShortcut` setting — see [Configuration](/getting-started/configuration.md#top-level-fields).

{% hint style="info" %}
Two different shortcuts: **`Ctrl+Shift+K`** summons the whole app system-wide, while **`Cmd+K`** opens the Spotlight palette once Kira is focused.
{% endhint %}

## Deep links (`kira://`)

Kira registers the `kira://` URL scheme, so links can open a specific resource directly. `account` and `role` are required (except for `kira://about`); `region` is optional but recommended.

| Link                                                                                                  | Opens                                        |
| ----------------------------------------------------------------------------------------------------- | -------------------------------------------- |
| `kira://ecs?account=<id>&role=<role>[&region=<region>][&cluster=<cluster>]`                           | The ECS tab (optionally focusing a cluster). |
| `kira://ecs/task-def?account=<id>&role=<role>&region=<region>&cluster=<cluster>&taskDef=<family:rev>` | A specific task definition.                  |
| `kira://ecs/compare?account=<id>&role=<role>&region=<region>&cluster=<cluster>&taskDef=<family:rev>`  | Task-definition compare view.                |
| `kira://secrets?account=<id>&role=<role>[&region=<region>]`                                           | The Secrets tab.                             |
| `kira://secrets/view?account=<id>&role=<role>&region=<region>&secretId=<name-or-arn>`                 | A specific secret.                           |
| `kira://s3?account=<id>&role=<role>[&region=<region>]`                                                | The S3 tab.                                  |
| `kira://s3/bucket?account=<id>&role=<role>&region=<region>&bucket=<name>[&prefix=<dir/>]`             | A bucket (optionally at a prefix).           |
| `kira://s3/object?account=<id>&role=<role>&region=<region>&bucket=<name>&key=<objectKey>`             | A specific object.                           |
| `kira://databases?account=<id>&role=<role>[&region=<region>]`                                         | The Databases tab.                           |
| `kira://databases/dynamo?account=<id>&role=<role>&region=<region>&table=<name>`                       | A specific DynamoDB table.                   |
| `kira://about`                                                                                        | The About screen (no parameters).            |

These links are great for runbooks, dashboards, and chat messages — clicking one opens Kira straight at the resource. If Kira is launched by a deep link before it's ready, it buffers the link and navigates as soon as the app is up.


---

# 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/navigation.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.