diff --git a/docs/cast-issue-create.svg b/docs/cast-issue-create.svg
index 1ccc142e..dd380c4d 100644
--- a/docs/cast-issue-create.svg
+++ b/docs/cast-issue-create.svg
@@ -12,7 +12,8 @@
xmlns="http://www.w3.org/2000/svg"
xmlns:xlink="http://www.w3.org/1999/xlink"
>
-
+ }
+
- ❯
+
+ ❯
+
@@ -1300,7 +1315,9 @@
>0L,
0B
- ~
+
+ ~
+
--
INSERT
@@ -1310,7 +1327,9 @@
class="h"
>--
- markdown
+
+ markdown
+
markdown
descri
@@ -1327,7 +1346,9 @@
markdown
description
- :wq
+
+ :wq
+
Description
entered
diff --git a/docs/cast-issue-start.svg b/docs/cast-issue-start.svg
index edc08372..07bfe61b 100644
--- a/docs/cast-issue-start.svg
+++ b/docs/cast-issue-start.svg
@@ -12,7 +12,8 @@
xmlns="http://www.w3.org/2000/svg"
xmlns:xlink="http://www.w3.org/1999/xlink"
>
-
+ }
+
- ❯
+
+ ❯
+
@@ -421,7 +431,9 @@
class="c"
>issues
- ⠋
+
+ ⠋
+
?
Branch
diff --git a/skills/linear-cli/SKILL.md b/skills/linear-cli/SKILL.md
index 024a2fff..3ddc180f 100644
--- a/skills/linear-cli/SKILL.md
+++ b/skills/linear-cli/SKILL.md
@@ -192,6 +192,7 @@ linear issue relation add
linear issue relation delete
linear issue relation list
linear issue start
+linear issue state
linear issue title
linear issue update
linear issue url
diff --git a/skills/linear-cli/references/api.md b/skills/linear-cli/references/api.md
index 3b308aff..2c492b69 100644
--- a/skills/linear-cli/references/api.md
+++ b/skills/linear-cli/references/api.md
@@ -13,11 +13,10 @@ Description:
Options:
- -h, --help - Show this help.
- --workspace - Target workspace (uses credentials)
- --variable - Variable in key=value format (coerces booleans, numbers, null; @file reads from
- path)
- --variables-json - JSON object of variables (merged with --variable, which takes precedence)
- --paginate - Auto-paginate a single connection field using cursor pagination
+ -h, --help - Show this help.
+ --workspace - Target workspace (uses credentials)
+ --variable - Variable in key=value format (coerces booleans, numbers, null; @file reads from path)
+ --variables-json - JSON object of variables (merged with --variable, which takes precedence)
+ --paginate - Auto-paginate a single connection field using cursor pagination
--silent - Suppress response output (exit code still reflects errors)
```
diff --git a/skills/linear-cli/references/issue.md b/skills/linear-cli/references/issue.md
index 1131c17f..54549b5a 100644
--- a/skills/linear-cli/references/issue.md
+++ b/skills/linear-cli/references/issue.md
@@ -22,6 +22,7 @@ Commands:
mine, list, l - List your issues
query, q - Query issues with structured filters
title [issueId] - Print the issue title
+ state [issueId] - Print the issue's current state
start [issueId] - Start working on an issue
view, v [issueId] - View issue details (default) or open in browser/app
url [issueId] - Print the issue URL
@@ -75,11 +76,10 @@ Description:
Options:
- -h, --help - Show this help.
- --workspace - Target workspace (uses credentials)
- -j, --json - Output as JSON
- --status - Filter by session status (Values: "pending", "active", "complete", "awaitingInput",
- "error", "stale")
+ -h, --help - Show this help.
+ --workspace - Target workspace (uses credentials)
+ -j, --json - Output as JSON
+ --status - Filter by session status (Values: "pending", "active", "complete", "awaitingInput", "error", "stale")
```
##### view
@@ -111,12 +111,11 @@ Description:
Options:
- -h, --help - Show this help.
- --workspace - Target workspace (uses credentials)
- -t, --title - Custom title for the attachment
- -c, --comment - Create a linked comment with this body; the file remains a sidebar attachment
- --public - Upload images to a public, unauthenticated URL (default: private,
- workspace-members only)
+ -h, --help - Show this help.
+ --workspace - Target workspace (uses credentials)
+ -t, --title - Custom title for the attachment
+ -c, --comment - Create a linked comment with this body; the file remains a sidebar attachment
+ --public - Upload images to a public, unauthenticated URL (default: private, workspace-members only)
```
### comment
@@ -156,15 +155,13 @@ Description:
Options:
- -h, --help - Show this help.
- --workspace - Target workspace (uses credentials)
- -b, --body - Comment body text
- --body-file - Read comment body from a file (preferred for markdown content)
- -p, --parent - Parent comment ID for replies
- -a, --attach - Upload a file and add its Markdown link to the comment (images render inline;
- repeatable)
- --public - Upload attached images to a public, unauthenticated URL (default: private,
- workspace-members only)
+ -h, --help - Show this help.
+ --workspace - Target workspace (uses credentials)
+ -b, --body - Comment body text
+ --body-file - Read comment body from a file (preferred for markdown content)
+ -p, --parent - Parent comment ID for replies
+ -a, --attach - Upload a file and add its Markdown link to the comment (images render inline; repeatable)
+ --public - Upload attached images to a public, unauthenticated URL (default: private, workspace-members only)
```
##### delete
@@ -245,25 +242,25 @@ Description:
Options:
- -h, --help - Show this help.
- --workspace - Target workspace (uses credentials)
- --start - Start the issue after creation
- -a, --assignee - Assign the issue to 'self' or someone (by username or name)
- --due-date - Due date of the issue
- --parent - Parent issue (if any) as a team_number code
- -p, --priority - Priority of the issue (1-4, descending priority)
- --estimate - Points estimate of the issue
- -d, --description - Description of the issue
- --description-file - Read description from a file (preferred for markdown content)
- -l, --label