link git:20260521.f34ad5eB

Immutable. This exact content never changes and is served at /api/v1/blob/817d7122467ac12d.

---
description: Manage Jira issue links (blocks, relates, duplicates, etc.) with jirac — list link types, add a link, or delete an existing link
---

Manage links between Jira issues using `jirac`.

Steps:
1. Check that `jirac` is available by running `jirac --version`. If missing, tell the user to install it (`cargo install jira-commands`).
2. Determine the operation from the user's request:
   - **List link types**: `jirac issue link list-types`
   - **Add link**: needs link type (e.g. Blocks, Relates, Duplicates), outward key (source), inward key (target).
   - **Delete link**: needs the link ID (obtain it from `jirac issue view <KEY>`).
3. For unfamiliar link type names, run `jirac issue link list-types` first.
4. Run the appropriate command and report the resulting link.

Notes:
- The **outward** issue is the "source" of the link (the blocker, the duplicate). The **inward** issue is the "target" (the blocked, the original).
- Common link type names: `Blocks`, `Relates`, `Duplicates`, `Clones`, `Cloners`. Casing matters — match what `list-types` returns.
- Adding the same link twice is allowed by Jira and produces duplicate entries — check existing links via `jirac issue view <KEY>` before adding.

Examples:
- "what link types are available" → `jirac issue link list-types`
- "PROJ-1 blocks PROJ-2" → `jirac issue link add --link-type Blocks PROJ-1 PROJ-2`
- "PROJ-3 is related to PROJ-4" → `jirac issue link add --link-type Relates PROJ-3 PROJ-4`
- "PROJ-5 duplicates PROJ-6" → `jirac issue link add --link-type Duplicates PROJ-5 PROJ-6`
- "add a comment when linking" → `jirac issue link add --link-type Blocks --comment 'blocked by infra change' PROJ-1 PROJ-2`
- "delete link 10042" → `jirac issue link delete 10042`