# JirAI: Settings reference

> For the complete documentation index, see [llms.txt](https://edgafner.github.io/llms.txt).

> **TL;DR**
> Settings: `Settings | Tools | JirAI`
>
>
>
> Open the Settings dialog: `Ctrl+Alt+S` (macOS: `⌘ ,`)

JirAI settings are under `Settings | Tools | JirAI`.

All pages except Doc Push apply to the whole IDE; Doc Push applies to the current project.

## JirAI

`Settings | Tools | JirAI`

Account
: The Jira Cloud account JirAI is signed in to.
:
:
:
: Click + to sign in, or select the account and click − to sign out.
:
:
:
: JirAI connects to one site at a time, so + is unavailable while you are signed in.

Resources
: The JirAI documentation link opens this documentation.

See [Sign in and manage your account](jirai-sign-in-and-configuration.html).

## Field Visibility

`Settings | Tools | JirAI | Field Visibility`

Lists the custom fields hidden from the issue details tab, one rule per row:

Site
: The Jira site address, for example `https://demo-org.atlassian.net`.

Field name
: A name shown in the table only.

Field ID
: The field ID the rule matches, for example `customfield_10020`.

Scope
: All projects, one project or one issue.

Target
: The project key or issue key; empty for all projects.

Click + to add a rule in the Add Hidden Field Rule dialog, or select rules and click − to unhide the fields.

See [Hide custom fields](jira-field-visibility.html).

## Doc Push

`Settings | Tools | JirAI | Doc Push` (current project only)

Preset
: Choose Superpowers, spec-kit or None.

Doc kinds table
: Lists your own kinds first, then the preset's kinds, with the Kind, Path pattern, Project key, Issue type, Labels and Components columns.
:
:
:
: Kinds are tried from top to bottom, and the first match wins.

Path pattern
: Matches the document path inside the project: `*` stays within one folder, `**` crosses folders, and `?` matches one character.

Targets
: Set the project key, issue type, labels and components for each kind.
:
:
:
: You can type names; JirAI resolves them when the Create form opens.

By default, JirAI picks the preset from the project's folders the first time you push a document.

The target columns stay read-only until you open the JirAI tool window while you are signed in.

See [Configure presets in Settings](jirai-ai-workflows.html#presets-settings).

## Metrics

`Settings | Tools | JirAI | Metrics`

When a space has more than 10,000 work items, JirAI loads a sample of 10,000:

Keep the newest work items (recent weeks stay exact)
: The default. Recent weeks are complete, and the oldest weeks under-count.

Keep the oldest work items (long-running work stays visible)
: Long-running work stays in the sample, and recent weeks under-count.

The change applies the next time a space tab loads or refreshes.

See [Large spaces](jirai-metrics.html#large-spaces).

## House Standard

`Settings | Tools | JirAI | House Standard`

Rules that AI assistants are told about when they validate a draft issue, stored for the Jira site you are signed in to.

Project
: The project key, or `*` for any project.

Issue type
: The issue type, or `*` for any type.

Rule
: The kind of rule: `FIELD_SET`, `DESCRIPTION_HEADING` or `FIELD_MATCHES`.

Target
: The field name, or the heading text for `DESCRIPTION_HEADING`.

Pattern
: A regular expression; used only by `FIELD_MATCHES`.

Note
: Optional. Your own explanation, which the assistant receives instead of the generated message.

See [Define a house standard](jirai-agent-tools.html#house-standard).

## Related IDE settings

Settings | Tools | MCP Server
: Turns on the IDE's MCP server, which the JirAI agent tools need. See [Turn on the agent tools](jirai-agent-tools.html#enable-agent-tools).

Settings | Appearance & Behavior | System Settings | HTTP Proxy
: The proxy JirAI uses. See [Use JirAI behind a corporate proxy](jirai-sign-in-and-configuration.html#corporate-proxy).

Settings | Appearance & Behavior | Notifications
: How JirAI notifications are shown.
:
:
:
: JirAI has the notification groups Jira issue delete, Jira attachments, JirAI doc push, Jira create and JirAI agent tools.

## Keyboard shortcuts

JirAI actions such as New Issue, Space Summary and Push to Jira have no default shortcut.

Run them with Find Action (`Ctrl+Shift+A`, macOS: `⌘ ⇧ A`), or assign shortcuts in `Settings | Keymap`.

New Issue and Space Summary become available once the JirAI tool window has opened in the project and shows you signed in.

| Where | Action | Keys |
| --- | --- | --- |
| Issue list | Open the selected issue | `Enter` or double-click |
| Issue list | Reload the list | The IDE Refresh shortcut (see `Settings \| Keymap`) |
| Issue list and filters | Exclude a filter value | `Shift`+click |
| Timeline | Post a comment | `Ctrl+Enter` (macOS: `⌘ ⏎`) |
| Timeline | New line in a comment | `Enter` |
| Timeline | Reload the timeline | The IDE Refresh shortcut |
| Description editor | Save the description | `Ctrl+Enter` (macOS: `⌘ ⏎`) |
| Description editor | Cancel editing | `Escape` |
| Space List | Open the selected work item | `Enter` or double-click |
| Space List | Unfold or fold the selected parent | `Right`, `Left` |
| Board | Next or previous column | `Tab`, `Shift+Tab` |
| Board | Move between cards | Arrow keys |
| Board | Open the card menu | `Shift+Enter` |

## See also

### Related topics

[JirAI: Sign in and manage your account](jirai-sign-in-and-configuration.html) [JirAI: Hide custom fields](jira-field-visibility.html) [JirAI: Push Markdown docs to Jira](jirai-ai-workflows.html) [JirAI: AI agent tools and house standard](jirai-agent-tools.html)

### Useful resources

[Notifications in JetBrains IDEs](https://www.jetbrains.com/help/idea/notifications.html)