inbox

The inbox command manages a local inbox of open Jira issues assigned to you. The watcher polls Jira in the background, stores discovered issues locally, and shows a desktop toast when a new issue appears. From the inbox you can pin, dismiss, open in the browser, or import issues into your local task list.

Usage

kasl inbox [OPTIONS] [COMMAND]

Running kasl inbox without a subcommand lists the active (non-dismissed) issues.

Options

• -n, --limit <N>: Show only the top N issues; the list is sorted by pin state, ranking field (e.g. Scoring), and priority

Commands

sync - Sync inbox from Jira

kasl inbox sync

Polls Jira immediately instead of waiting for the background cadence.

list - List active inbox issues

kasl inbox list [OPTIONS]

Options:

• -n, --limit <N>: Show only the top N issues

pin - Pin an inbox issue

kasl inbox pin <KEY>

Arguments:

• KEY: Issue key, e.g. PROJ-123

Pinned issues stay on top of the list.

unpin - Unpin an inbox issue

kasl inbox unpin <KEY>

Arguments:

• KEY: Issue key, e.g. PROJ-123

dismiss - Dismiss an inbox issue

kasl inbox dismiss <KEY>

Arguments:

• KEY: Issue key, e.g. PROJ-123

Hides an issue from the list.

open - Open issue URL in browser

kasl inbox open <KEY>

Arguments:

• KEY: Issue key, e.g. PROJ-123

take - Import issue into tasks

kasl inbox take <KEY>

Arguments:

• KEY: Issue key, e.g. PROJ-123

Imports the issue into local tasks (creates a task named KEY summary and dismisses the inbox entry).

Background Polling

Polling runs inside kasl watch (both daemon and --foreground modes). New issues trigger a desktop notification; clicking the toast opens the issue in the browser (Windows). Each issue is notified about only once.

Configuration

Polling is enabled by adding the jira_inbox section to the config; the jira section must be configured as well.

{
  "jira_inbox": {
    "enabled": true,
    "poll_interval_secs": 300,
    "notify": true,
    "custom_fields": [{ "id": "customfield_12345", "label": "Scoring" }],
    "sort_by_field": "customfield_12345"
  }
}

• enabled: Whether the watcher polls Jira (default true when the section is present)
• poll_interval_secs: Seconds between polls (default 300)
• notify: Show desktop toasts for new issues (default true)
• custom_fields: Extra Jira fields to fetch and display, such as a Scoring field
• sort_by_field: Field id used to rank the list in descending order

Examples

# Show the inbox
kasl inbox

# Top five issues by ranking
kasl inbox -n 5

# Sync now and show the result
kasl inbox sync
kasl inbox list

# Work with a specific issue
kasl inbox pin PROJ-123
kasl inbox open PROJ-123
kasl inbox take PROJ-123

Scripting

Every subcommand takes its issue key as an argument, so the inbox can be driven from scripts without any interactive prompt:

kasl inbox sync
kasl inbox take PROJ-123
kasl inbox dismiss PROJ-456