mirror of
https://github.com/prdlk/dotfiles.git
synced 2026-11-03 19:37:52 +00:00
chore(agents): update skill metadata timestamps, source URLs, and documentation wording across dot_agents files
This commit is contained in:
Prad Nukala committed
1 parent
12155ad58c
commit
c96c19c0f9
45 files changed
+1819
-1395
No files matched your search
@@ -29,6 +29,40 @@ Commands:
|
||||
|
||||
## Subcommands
|
||||
|
||||
### default
|
||||
|
||||
> Set the default workspace
|
||||
|
||||
```
|
||||
Usage: linear auth default [workspace]
|
||||
|
||||
Description:
|
||||
|
||||
Set the default workspace
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
```
|
||||
|
||||
### list
|
||||
|
||||
> List configured workspaces
|
||||
|
||||
```
|
||||
Usage: linear auth list
|
||||
|
||||
Description:
|
||||
|
||||
List configured workspaces
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
```
|
||||
|
||||
### login
|
||||
|
||||
> Add a workspace credential
|
||||
@@ -66,33 +100,16 @@ Options:
|
||||
-f, --force - Skip confirmation prompt
|
||||
```
|
||||
|
||||
### list
|
||||
### migrate
|
||||
|
||||
> List configured workspaces
|
||||
> Migrate plaintext credentials to system keyring
|
||||
|
||||
```
|
||||
Usage: linear auth list
|
||||
Usage: linear auth migrate
|
||||
|
||||
Description:
|
||||
|
||||
List configured workspaces
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
```
|
||||
|
||||
### default
|
||||
|
||||
> Set the default workspace
|
||||
|
||||
```
|
||||
Usage: linear auth default [workspace]
|
||||
|
||||
Description:
|
||||
|
||||
Set the default workspace
|
||||
Migrate plaintext credentials to system keyring
|
||||
|
||||
Options:
|
||||
|
||||
@@ -133,20 +150,3 @@ Options:
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
```
|
||||
|
||||
### migrate
|
||||
|
||||
> Migrate plaintext credentials to system keyring
|
||||
|
||||
```
|
||||
Usage: linear auth migrate
|
||||
|
||||
Description:
|
||||
|
||||
Migrate plaintext credentials to system keyring
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
```
|
||||
@@ -2,20 +2,21 @@
|
||||
|
||||
## Commands
|
||||
|
||||
- [api](./api.md) - Make a raw GraphQL API request
|
||||
- [auth](./auth.md) - Manage Linear authentication
|
||||
- [issue](./issue.md) - Manage Linear issues
|
||||
- [team](./team.md) - Manage Linear teams
|
||||
- [project](./project.md) - Manage Linear projects
|
||||
- [project-update](./project-update.md) - Manage project status updates
|
||||
- [config](./config.md) - Interactively generate .linear.toml configuration
|
||||
- [cycle](./cycle.md) - Manage Linear team cycles
|
||||
- [milestone](./milestone.md) - Manage Linear project milestones
|
||||
- [document](./document.md) - Manage Linear documents
|
||||
- [initiative](./initiative.md) - Manage Linear initiatives
|
||||
- [initiative-update](./initiative-update.md) - Manage initiative status updates (timeline posts)
|
||||
- [issue](./issue.md) - Manage Linear issues
|
||||
- [label](./label.md) - Manage Linear issue labels
|
||||
- [document](./document.md) - Manage Linear documents
|
||||
- [config](./config.md) - Interactively generate .linear.toml configuration
|
||||
- [milestone](./milestone.md) - Manage Linear project milestones
|
||||
- [project](./project.md) - Manage Linear projects
|
||||
- [project-update](./project-update.md) - Manage project status updates
|
||||
- [schema](./schema.md) - Print the GraphQL schema to stdout
|
||||
- [api](./api.md) - Make a raw GraphQL API request
|
||||
- [team](./team.md) - Manage Linear teams
|
||||
- [user](./user.md) - Manage Linear users
|
||||
|
||||
## Quick Reference
|
||||
|
||||
|
||||
@@ -27,48 +27,6 @@ Commands:
|
||||
|
||||
## Subcommands
|
||||
|
||||
### list
|
||||
|
||||
> List documents
|
||||
|
||||
```
|
||||
Usage: linear document list
|
||||
|
||||
Description:
|
||||
|
||||
List documents
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
--project <project> - Filter by project (slug or name)
|
||||
--issue <issue> - Filter by issue (identifier like TC-123)
|
||||
--json - Output as JSON
|
||||
--limit <limit> - Limit results (Default: 50)
|
||||
```
|
||||
|
||||
### view
|
||||
|
||||
> View a document's content
|
||||
|
||||
```
|
||||
Usage: linear document view <id>
|
||||
|
||||
Description:
|
||||
|
||||
View a document's content
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
--raw - Output raw markdown without rendering
|
||||
-w, --web - Open document in browser
|
||||
--json - Output full document as JSON
|
||||
--no-download - Keep remote URLs instead of downloading files
|
||||
```
|
||||
|
||||
### create
|
||||
|
||||
> Create a new document
|
||||
@@ -82,40 +40,17 @@ Description:
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-t, --title <title> - Document title (required)
|
||||
-c, --content <content> - Markdown content (inline)
|
||||
-f, --content-file <path> - Read content from file
|
||||
--project <project> - Attach to project (slug or ID)
|
||||
--issue <issue> - Attach to issue (identifier like TC-123)
|
||||
--icon <icon> - Document icon (emoji)
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-t, --title <title> - Document title (required)
|
||||
-c, --content <content> - Markdown content (inline)
|
||||
-f, --content-file <path> - Read content from file
|
||||
--project <project> - Attach to project (UUID, slug ID, or name)
|
||||
--issue <issue> - Attach to issue (identifier like TC-123)
|
||||
--icon <icon> - Document icon (emoji)
|
||||
-i, --interactive - Interactive mode with prompts
|
||||
```
|
||||
|
||||
### update
|
||||
|
||||
> Update an existing document
|
||||
|
||||
```
|
||||
Usage: linear document update <documentId>
|
||||
|
||||
Description:
|
||||
|
||||
Update an existing document
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-t, --title <title> - New title for the document
|
||||
-c, --content <content> - New markdown content (inline)
|
||||
-f, --content-file <path> - Read new content from file
|
||||
--icon <icon> - New icon (emoji)
|
||||
-e, --edit - Open current content in $EDITOR for editing
|
||||
--force - Update content even when document comments may lose inline anchors
|
||||
```
|
||||
|
||||
### delete
|
||||
|
||||
> Delete a document (moves to trash)
|
||||
@@ -136,3 +71,69 @@ Options:
|
||||
--bulk-file <file> - Read document slugs/IDs from a file (one per line)
|
||||
--bulk-stdin - Read document slugs/IDs from stdin
|
||||
```
|
||||
|
||||
### list
|
||||
|
||||
> List documents
|
||||
|
||||
```
|
||||
Usage: linear document list
|
||||
|
||||
Description:
|
||||
|
||||
List documents
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
--project <project> - Filter by project (slug or name)
|
||||
--issue <issue> - Filter by issue (identifier like TC-123)
|
||||
--json - Output as JSON
|
||||
--limit <limit> - Limit results (Default: 50)
|
||||
```
|
||||
|
||||
### update
|
||||
|
||||
> Update an existing document
|
||||
|
||||
```
|
||||
Usage: linear document update <documentId>
|
||||
|
||||
Description:
|
||||
|
||||
Update an existing document
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-t, --title <title> - New title for the document
|
||||
-c, --content <content> - New markdown content (inline)
|
||||
-f, --content-file <path> - Read new content from file
|
||||
--icon <icon> - New icon (emoji)
|
||||
--project <project> - Attach to project (UUID, slug ID, or name)
|
||||
-e, --edit - Open current content in $EDITOR for editing
|
||||
--force - Update content even when document comments may lose inline anchors
|
||||
```
|
||||
|
||||
### view
|
||||
|
||||
> View a document's content
|
||||
|
||||
```
|
||||
Usage: linear document view <id>
|
||||
|
||||
Description:
|
||||
|
||||
View a document's content
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
--raw - Output raw markdown without rendering
|
||||
-w, --web - Open document in browser
|
||||
--json - Output full document as JSON
|
||||
--no-download - Keep remote URLs instead of downloading files
|
||||
```
|
||||
@@ -31,48 +31,43 @@ Commands:
|
||||
|
||||
## Subcommands
|
||||
|
||||
### list
|
||||
### add-project
|
||||
|
||||
> List initiatives
|
||||
> Link a project to an initiative
|
||||
|
||||
```
|
||||
Usage: linear initiative list
|
||||
Usage: linear initiative add-project <initiative> <project>
|
||||
|
||||
Description:
|
||||
|
||||
List initiatives
|
||||
Link a project to an initiative
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-s, --status <status> - Filter by status (active, planned, completed)
|
||||
--all-statuses - Show all statuses (default: active only)
|
||||
-o, --owner <owner> - Filter by owner (username or email)
|
||||
-w, --web - Open initiatives page in web browser
|
||||
-a, --app - Open initiatives page in Linear.app
|
||||
-j, --json - Output as JSON
|
||||
--archived - Include archived initiatives
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
--sort-order <sortOrder> - Sort order within initiative
|
||||
```
|
||||
|
||||
### view
|
||||
### archive
|
||||
|
||||
> View initiative details
|
||||
> Archive a Linear initiative
|
||||
|
||||
```
|
||||
Usage: linear initiative view <initiativeId>
|
||||
Usage: linear initiative archive [initiativeId]
|
||||
|
||||
Description:
|
||||
|
||||
View initiative details
|
||||
Archive a Linear initiative
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-w, --web - Open in web browser
|
||||
-a, --app - Open in Linear.app
|
||||
-j, --json - Output as JSON
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-y, --force - Skip confirmation prompt
|
||||
--bulk <ids...> - Archive multiple initiatives by ID, slug, or name
|
||||
--bulk-file <file> - Read initiative IDs from a file (one per line)
|
||||
--bulk-stdin - Read initiative IDs from stdin
|
||||
```
|
||||
|
||||
### create
|
||||
@@ -100,27 +95,87 @@ Options:
|
||||
-i, --interactive - Interactive mode (default if no flags provided)
|
||||
```
|
||||
|
||||
### archive
|
||||
### delete
|
||||
|
||||
> Archive a Linear initiative
|
||||
> Permanently delete a Linear initiative
|
||||
|
||||
```
|
||||
Usage: linear initiative archive [initiativeId]
|
||||
Usage: linear initiative delete [initiativeId]
|
||||
|
||||
Description:
|
||||
|
||||
Archive a Linear initiative
|
||||
Permanently delete a Linear initiative
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-y, --force - Skip confirmation prompt
|
||||
--bulk <ids...> - Archive multiple initiatives by ID, slug, or name
|
||||
--bulk-file <file> - Read initiative IDs from a file (one per line)
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-y, --force - Skip confirmation prompt
|
||||
--bulk <ids...> - Delete multiple initiatives by ID, slug, or name
|
||||
--bulk-file <file> - Read initiative IDs from a file (one per line)
|
||||
--bulk-stdin - Read initiative IDs from stdin
|
||||
```
|
||||
|
||||
### list
|
||||
|
||||
> List initiatives
|
||||
|
||||
```
|
||||
Usage: linear initiative list
|
||||
|
||||
Description:
|
||||
|
||||
List initiatives
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-s, --status <status> - Filter by status (active, planned, completed)
|
||||
--all-statuses - Show all statuses (default: active only)
|
||||
-o, --owner <owner> - Filter by owner (username or email)
|
||||
-w, --web - Open initiatives page in web browser
|
||||
-a, --app - Open initiatives page in Linear.app
|
||||
-j, --json - Output as JSON
|
||||
--archived - Include archived initiatives
|
||||
```
|
||||
|
||||
### remove-project
|
||||
|
||||
> Unlink a project from an initiative
|
||||
|
||||
```
|
||||
Usage: linear initiative remove-project <initiative> <project>
|
||||
|
||||
Description:
|
||||
|
||||
Unlink a project from an initiative
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-y, --force - Skip confirmation prompt
|
||||
```
|
||||
|
||||
### unarchive
|
||||
|
||||
> Unarchive a Linear initiative
|
||||
|
||||
```
|
||||
Usage: linear initiative unarchive <initiativeId>
|
||||
|
||||
Description:
|
||||
|
||||
Unarchive a Linear initiative
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-y, --force - Skip confirmation prompt
|
||||
```
|
||||
|
||||
### update
|
||||
|
||||
> Update a Linear initiative
|
||||
@@ -146,77 +201,22 @@ Options:
|
||||
-i, --interactive - Interactive mode for updates
|
||||
```
|
||||
|
||||
### unarchive
|
||||
### view
|
||||
|
||||
> Unarchive a Linear initiative
|
||||
> View initiative details
|
||||
|
||||
```
|
||||
Usage: linear initiative unarchive <initiativeId>
|
||||
Usage: linear initiative view <initiativeId>
|
||||
|
||||
Description:
|
||||
|
||||
Unarchive a Linear initiative
|
||||
View initiative details
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-y, --force - Skip confirmation prompt
|
||||
```
|
||||
|
||||
### delete
|
||||
|
||||
> Permanently delete a Linear initiative
|
||||
|
||||
```
|
||||
Usage: linear initiative delete [initiativeId]
|
||||
|
||||
Description:
|
||||
|
||||
Permanently delete a Linear initiative
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-y, --force - Skip confirmation prompt
|
||||
--bulk <ids...> - Delete multiple initiatives by ID, slug, or name
|
||||
--bulk-file <file> - Read initiative IDs from a file (one per line)
|
||||
--bulk-stdin - Read initiative IDs from stdin
|
||||
```
|
||||
|
||||
### add-project
|
||||
|
||||
> Link a project to an initiative
|
||||
|
||||
```
|
||||
Usage: linear initiative add-project <initiative> <project>
|
||||
|
||||
Description:
|
||||
|
||||
Link a project to an initiative
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
--sort-order <sortOrder> - Sort order within initiative
|
||||
```
|
||||
|
||||
### remove-project
|
||||
|
||||
> Unlink a project from an initiative
|
||||
|
||||
```
|
||||
Usage: linear initiative remove-project <initiative> <project>
|
||||
|
||||
Description:
|
||||
|
||||
Unlink a project from an initiative
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-y, --force - Skip confirmation prompt
|
||||
-w, --web - Open in web browser
|
||||
-a, --app - Open in Linear.app
|
||||
-j, --json - Output as JSON
|
||||
```
|
||||
@@ -18,28 +18,294 @@ Options:
|
||||
|
||||
Commands:
|
||||
|
||||
id - Print the issue based on the current git branch
|
||||
mine, list, l - List your issues
|
||||
query, q - Query issues with structured filters
|
||||
title [issueId] - Print the issue title
|
||||
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
|
||||
describe [issueId] - Print the issue title and Linear-issue trailer
|
||||
commits [issueId] - Show all commits for a Linear issue (jj only)
|
||||
pull-request, pr [issueId] - Create a GitHub pull request with issue details
|
||||
delete, d [issueId] - Delete an issue
|
||||
create - Create a linear issue
|
||||
update [issueId] - Update a linear issue
|
||||
comment - Manage issue comments
|
||||
attach <issueId> <filepath> - Attach a file to an issue
|
||||
link <urlOrIssueId> [url] - Link a URL to an issue
|
||||
relation - Manage issue relations (dependencies)
|
||||
id - Print the issue based on the current git branch
|
||||
mine, list, l - List your issues
|
||||
query, q - Query issues with structured filters
|
||||
title [issueId] - Print the issue title
|
||||
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
|
||||
describe [issueId] - Print the issue title and Linear-issue trailer
|
||||
commits [issueId] - Show all commits for a Linear issue (jj only)
|
||||
pull-request, pr [issueId] - Create a GitHub pull request with issue details
|
||||
delete, d [issueId] - Delete an issue
|
||||
create - Create a linear issue
|
||||
update [issueId] - Update a linear issue
|
||||
comment - Manage issue comments
|
||||
attach <issueId> <filepath> - Create a sidebar link attachment on an issue (images do not render inline)
|
||||
link <urlOrIssueId> [url] - Link a URL to an issue
|
||||
relation - Manage issue relations (dependencies)
|
||||
agent-session - Manage agent sessions for an issue
|
||||
```
|
||||
|
||||
## Subcommands
|
||||
|
||||
### agent-session
|
||||
|
||||
> Manage agent sessions for an issue
|
||||
|
||||
```
|
||||
Usage: linear issue agent-session
|
||||
|
||||
Description:
|
||||
|
||||
Manage agent sessions for an issue
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
|
||||
Commands:
|
||||
|
||||
list [issueId] - List agent sessions for an issue
|
||||
view, v <sessionId> - View agent session details
|
||||
```
|
||||
|
||||
#### agent-session subcommands
|
||||
|
||||
##### list
|
||||
|
||||
```
|
||||
Usage: linear issue agent-session list [issueId]
|
||||
|
||||
Description:
|
||||
|
||||
List agent sessions for an issue
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-j, --json - Output as JSON
|
||||
--status <status> - Filter by session status (Values: "pending", "active", "complete", "awaitingInput",
|
||||
"error", "stale")
|
||||
```
|
||||
|
||||
##### view
|
||||
|
||||
```
|
||||
Usage: linear issue agent-session view <sessionId>
|
||||
|
||||
Description:
|
||||
|
||||
View agent session details
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-j, --json - Output as JSON
|
||||
```
|
||||
|
||||
### attach
|
||||
|
||||
> Create a sidebar link attachment on an issue (images do not render inline)
|
||||
|
||||
```
|
||||
Usage: linear issue attach <issueId> <filepath>
|
||||
|
||||
Description:
|
||||
|
||||
Create a sidebar link attachment on an issue (images do not render inline)
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-t, --title <title> - Custom title for the attachment
|
||||
-c, --comment <body> - 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
|
||||
|
||||
> Manage issue comments
|
||||
|
||||
```
|
||||
Usage: linear issue comment
|
||||
|
||||
Description:
|
||||
|
||||
Manage issue comments
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
|
||||
Commands:
|
||||
|
||||
add [issueId] - Add a comment or reply; images uploaded with --attach render inline
|
||||
delete <commentId> - Delete a comment
|
||||
update <commentId> - Update an existing comment
|
||||
list [issueId] - List comments for an issue
|
||||
```
|
||||
|
||||
#### comment subcommands
|
||||
|
||||
##### add
|
||||
|
||||
```
|
||||
Usage: linear issue comment add [issueId]
|
||||
|
||||
Description:
|
||||
|
||||
Add a comment or reply; images uploaded with --attach render inline
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-b, --body <text> - Comment body text
|
||||
--body-file <path> - Read comment body from a file (preferred for markdown content)
|
||||
-p, --parent <id> - Parent comment ID for replies
|
||||
-a, --attach <filepath> - 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
|
||||
|
||||
```
|
||||
Usage: linear issue comment delete <commentId>
|
||||
|
||||
Description:
|
||||
|
||||
Delete a comment
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
```
|
||||
|
||||
##### list
|
||||
|
||||
```
|
||||
Usage: linear issue comment list [issueId]
|
||||
|
||||
Description:
|
||||
|
||||
List comments for an issue
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-j, --json - Output as JSON
|
||||
```
|
||||
|
||||
##### update
|
||||
|
||||
```
|
||||
Usage: linear issue comment update <commentId>
|
||||
|
||||
Description:
|
||||
|
||||
Update an existing comment
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-b, --body <text> - New comment body text
|
||||
--body-file <path> - Read comment body from a file (preferred for markdown content)
|
||||
```
|
||||
|
||||
### commits
|
||||
|
||||
> Show all commits for a Linear issue (jj only)
|
||||
|
||||
```
|
||||
Usage: linear issue commits [issueId]
|
||||
|
||||
Description:
|
||||
|
||||
Show all commits for a Linear issue (jj only)
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
```
|
||||
|
||||
### create
|
||||
|
||||
> Create a linear issue
|
||||
|
||||
```
|
||||
Usage: linear issue create
|
||||
|
||||
Description:
|
||||
|
||||
Create a linear issue
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
--start - Start the issue after creation
|
||||
-a, --assignee <assignee> - Assign the issue to 'self' or someone (by username or name)
|
||||
--due-date <dueDate> - Due date of the issue
|
||||
--parent <parent> - Parent issue (if any) as a team_number code
|
||||
-p, --priority <priority> - Priority of the issue (1-4, descending priority)
|
||||
--estimate <estimate> - Points estimate of the issue
|
||||
-d, --description <description> - Description of the issue
|
||||
--description-file <path> - Read description from a file (preferred for markdown content)
|
||||
-l, --label <label> - Issue label associated with the issue. May be repeated.
|
||||
--team <team> - Team associated with the issue (if not your default team)
|
||||
--project <project> - Project for the issue (UUID, slug ID, or name)
|
||||
-s, --state <state> - Workflow state for the issue (by name or type)
|
||||
--milestone <milestone> - Project milestone (UUID, or name when --project is set)
|
||||
--cycle <cycle> - Cycle name, number, 'active'/'now', 'next', 'previous', or a relative offset
|
||||
like +1 (use --cycle=-1 for negatives)
|
||||
--no-use-default-template - Do not use default template for the issue
|
||||
--no-interactive - Disable interactive prompts
|
||||
-t, --title <title> - Title of the issue
|
||||
```
|
||||
|
||||
### delete
|
||||
|
||||
> Delete an issue
|
||||
|
||||
```
|
||||
Usage: linear issue delete [issueId]
|
||||
|
||||
Description:
|
||||
|
||||
Delete an issue
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-y, --confirm - Skip confirmation prompt
|
||||
--bulk <ids...> - Delete multiple issues by identifier (e.g., TC-123 TC-124)
|
||||
--bulk-file <file> - Read issue identifiers from a file (one per line)
|
||||
--bulk-stdin - Read issue identifiers from stdin
|
||||
```
|
||||
|
||||
### describe
|
||||
|
||||
> Print the issue title and Linear-issue trailer
|
||||
|
||||
```
|
||||
Usage: linear issue describe [issueId]
|
||||
|
||||
Description:
|
||||
|
||||
Print the issue title and Linear-issue trailer
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-r, --references, --ref - Use 'References' instead of 'Fixes' for the Linear issue link
|
||||
```
|
||||
|
||||
### id
|
||||
|
||||
> Print the issue based on the current git branch
|
||||
@@ -57,6 +323,30 @@ Options:
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
```
|
||||
|
||||
### link
|
||||
|
||||
> Link a URL to an issue
|
||||
|
||||
```
|
||||
Usage: linear issue link <urlOrIssueId> [url]
|
||||
|
||||
Description:
|
||||
|
||||
Link a URL to an issue
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-t, --title <title> - Custom title for the link
|
||||
|
||||
Examples:
|
||||
|
||||
Link a URL to issue detected from branch linear issue link https://github.com/org/repo/pull/123
|
||||
Link a URL to a specific issue linear issue link ENG-123 https://github.com/org/repo/pull/123
|
||||
Link with a custom title linear issue link ENG-123 https://example.com --title "Design doc"
|
||||
```
|
||||
|
||||
### mine
|
||||
|
||||
> List your issues
|
||||
@@ -70,26 +360,49 @@ Description:
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-s, --state <state> - Filter by issue state (can be repeated for multiple states) (Default: [ "unstarted" ], Values: "triage", "backlog",
|
||||
"unstarted", "started", "completed", "canceled")
|
||||
--all-states - Show issues from all states
|
||||
--sort <sort> - Sort order (can also be set via LINEAR_ISSUE_SORT) (Values: "manual", "priority")
|
||||
--team <team> - Team to list issues for (if not your default team)
|
||||
--project <project> - Filter by project name
|
||||
--project-label <projectLabel> - Filter by project label name (shows issues from all projects with this label)
|
||||
--cycle <cycle> - Filter by cycle name, number, or 'active'
|
||||
--milestone <milestone> - Filter by project milestone name (requires --project)
|
||||
-l, --label <label> - Filter by label name (can be repeated for multiple labels)
|
||||
--limit <limit> - Maximum number of issues to fetch (default: 50, use 0 for unlimited) (Default: 50)
|
||||
--created-after <date> - Filter issues created after this date (ISO 8601 or YYYY-MM-DD)
|
||||
--updated-after <date> - Filter issues updated after this date (ISO 8601 or YYYY-MM-DD)
|
||||
-w, --web - Open in web browser
|
||||
-a, --app - Open in Linear.app
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-s, --state <state> - Filter by issue state (can be repeated for multiple states) (Default: [ "unstarted" ], Values: "triage", "backlog",
|
||||
"unstarted", "started", "completed", "canceled")
|
||||
--all-states - Show issues from all states
|
||||
--sort <sort> - Sort order (default: priority, can also be set via LINEAR_ISSUE_SORT) (Values: "manual", "priority")
|
||||
--team <team> - Team to list issues for (if not your default team)
|
||||
--project <project> - Filter by project (UUID, slug ID, or name)
|
||||
--project-label <projectLabel> - Filter by project label name (shows issues from all projects with this label)
|
||||
--cycle <cycle> - Filter by cycle name, number, 'active'/'now', 'next', 'previous', or a relative
|
||||
offset like +1
|
||||
--milestone <milestone> - Filter by project milestone (UUID, or name when --project is set)
|
||||
-l, --label <label> - Filter by label name (can be repeated for multiple labels)
|
||||
--limit <limit> - Maximum number of issues to fetch (default: 50, use 0 for unlimited) (Default: 50)
|
||||
--created-after <date> - Filter issues created after this date (ISO 8601 or YYYY-MM-DD)
|
||||
--updated-after <date> - Filter issues updated after this date (ISO 8601 or YYYY-MM-DD)
|
||||
-w, --web - Open in web browser
|
||||
-a, --app - Open in Linear.app
|
||||
--no-pager - Disable automatic paging for long output
|
||||
```
|
||||
|
||||
### pull-request
|
||||
|
||||
> Create a GitHub pull request with issue details
|
||||
|
||||
```
|
||||
Usage: linear issue pull-request [issueId]
|
||||
|
||||
Description:
|
||||
|
||||
Create a GitHub pull request with issue details
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
--base <branch> - The branch into which you want your code merged
|
||||
--draft - Create the pull request as a draft
|
||||
-t, --title <title> - Optional title for the pull request (Linear issue ID will be prefixed)
|
||||
--web - Open the pull request in the browser after creating it
|
||||
--head <branch> - The branch that contains commits for your pull request
|
||||
```
|
||||
|
||||
### query
|
||||
|
||||
> Query issues with structured filters
|
||||
@@ -116,10 +429,11 @@ Options:
|
||||
-A, --all-assignees - Show issues for all assignees (this is the default)
|
||||
-U, --unassigned - Show only unassigned issues
|
||||
--sort <sort> - Sort order: manual or priority (default: priority, not available with --search) (Values: "manual", "priority")
|
||||
--project <project> - Filter by project name
|
||||
--project <project> - Filter by project (UUID, slug ID, or name)
|
||||
--project-label <projectLabel> - Filter by project label name (shows issues from all projects with this label)
|
||||
--cycle <cycle> - Filter by cycle name, number, or 'active'
|
||||
--milestone <milestone> - Filter by project milestone name (requires --project)
|
||||
--cycle <cycle> - Filter by cycle name, number, 'active'/'now', 'next', 'previous', or a relative
|
||||
offset like +1
|
||||
--milestone <milestone> - Filter by project milestone (UUID, or name when --project is set)
|
||||
-l, --label <label> - Filter by label name (can be repeated for multiple labels)
|
||||
--limit <limit> - Maximum number of issues to fetch (default: 50, use 0 for unlimited) (Default: 50)
|
||||
--created-after <date> - Filter issues created after this date (ISO 8601 or YYYY-MM-DD)
|
||||
@@ -129,368 +443,6 @@ Options:
|
||||
--no-pager - Disable automatic paging for long output
|
||||
```
|
||||
|
||||
### title
|
||||
|
||||
> Print the issue title
|
||||
|
||||
```
|
||||
Usage: linear issue title [issueId]
|
||||
|
||||
Description:
|
||||
|
||||
Print the issue title
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
```
|
||||
|
||||
### start
|
||||
|
||||
> Start working on an issue
|
||||
|
||||
```
|
||||
Usage: linear issue start [issueId]
|
||||
|
||||
Description:
|
||||
|
||||
Start working on an issue
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-A, --all-assignees - Show issues for all assignees
|
||||
-U, --unassigned - Show only unassigned issues
|
||||
-f, --from-ref <fromRef> - Git ref to create new branch from
|
||||
-b, --branch <branch> - Custom branch name to use instead of the issue identifier
|
||||
```
|
||||
|
||||
### view
|
||||
|
||||
> View issue details (default) or open in browser/app
|
||||
|
||||
```
|
||||
Usage: linear issue view [issueId]
|
||||
|
||||
Description:
|
||||
|
||||
View issue details (default) or open in browser/app
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-w, --web - Open in web browser
|
||||
-a, --app - Open in Linear.app
|
||||
--no-comments - Exclude comments from the output
|
||||
--show-resolved-threads - Include resolved comment threads in the output
|
||||
--no-pager - Disable automatic paging for long output
|
||||
-j, --json - Output issue data as JSON
|
||||
--no-download - Keep remote URLs instead of downloading files
|
||||
```
|
||||
|
||||
### url
|
||||
|
||||
> Print the issue URL
|
||||
|
||||
```
|
||||
Usage: linear issue url [issueId]
|
||||
|
||||
Description:
|
||||
|
||||
Print the issue URL
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
```
|
||||
|
||||
### describe
|
||||
|
||||
> Print the issue title and Linear-issue trailer
|
||||
|
||||
```
|
||||
Usage: linear issue describe [issueId]
|
||||
|
||||
Description:
|
||||
|
||||
Print the issue title and Linear-issue trailer
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-r, --references, --ref - Use 'References' instead of 'Fixes' for the Linear issue link
|
||||
```
|
||||
|
||||
### commits
|
||||
|
||||
> Show all commits for a Linear issue (jj only)
|
||||
|
||||
```
|
||||
Usage: linear issue commits [issueId]
|
||||
|
||||
Description:
|
||||
|
||||
Show all commits for a Linear issue (jj only)
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
```
|
||||
|
||||
### pull-request
|
||||
|
||||
> Create a GitHub pull request with issue details
|
||||
|
||||
```
|
||||
Usage: linear issue pull-request [issueId]
|
||||
|
||||
Description:
|
||||
|
||||
Create a GitHub pull request with issue details
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
--base <branch> - The branch into which you want your code merged
|
||||
--draft - Create the pull request as a draft
|
||||
-t, --title <title> - Optional title for the pull request (Linear issue ID will be prefixed)
|
||||
--web - Open the pull request in the browser after creating it
|
||||
--head <branch> - The branch that contains commits for your pull request
|
||||
```
|
||||
|
||||
### delete
|
||||
|
||||
> Delete an issue
|
||||
|
||||
```
|
||||
Usage: linear issue delete [issueId]
|
||||
|
||||
Description:
|
||||
|
||||
Delete an issue
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-y, --confirm - Skip confirmation prompt
|
||||
--bulk <ids...> - Delete multiple issues by identifier (e.g., TC-123 TC-124)
|
||||
--bulk-file <file> - Read issue identifiers from a file (one per line)
|
||||
--bulk-stdin - Read issue identifiers from stdin
|
||||
```
|
||||
|
||||
### create
|
||||
|
||||
> Create a linear issue
|
||||
|
||||
```
|
||||
Usage: linear issue create
|
||||
|
||||
Description:
|
||||
|
||||
Create a linear issue
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
--start - Start the issue after creation
|
||||
-a, --assignee <assignee> - Assign the issue to 'self' or someone (by username or name)
|
||||
--due-date <dueDate> - Due date of the issue
|
||||
--parent <parent> - Parent issue (if any) as a team_number code
|
||||
-p, --priority <priority> - Priority of the issue (1-4, descending priority)
|
||||
--estimate <estimate> - Points estimate of the issue
|
||||
-d, --description <description> - Description of the issue
|
||||
--description-file <path> - Read description from a file (preferred for markdown content)
|
||||
-l, --label <label> - Issue label associated with the issue. May be repeated.
|
||||
--team <team> - Team associated with the issue (if not your default team)
|
||||
--project <project> - Name or slug ID of the project with the issue
|
||||
-s, --state <state> - Workflow state for the issue (by name or type)
|
||||
--milestone <milestone> - Name of the project milestone
|
||||
--cycle <cycle> - Cycle name, number, or 'active'
|
||||
--no-use-default-template - Do not use default template for the issue
|
||||
--no-interactive - Disable interactive prompts
|
||||
-t, --title <title> - Title of the issue
|
||||
```
|
||||
|
||||
### update
|
||||
|
||||
> Update a linear issue
|
||||
|
||||
```
|
||||
Usage: linear issue update [issueId]
|
||||
|
||||
Description:
|
||||
|
||||
Update a linear issue
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-a, --assignee <assignee> - Assign the issue to 'self' or someone (by username or name)
|
||||
--due-date <dueDate> - Due date of the issue
|
||||
--parent <parent> - Parent issue (if any) as a team_number code
|
||||
-p, --priority <priority> - Priority of the issue (1-4, descending priority)
|
||||
--estimate <estimate> - Points estimate of the issue
|
||||
-d, --description <description> - Description of the issue
|
||||
--description-file <path> - Read description from a file (preferred for markdown content)
|
||||
-l, --label <label> - Issue label associated with the issue. May be repeated.
|
||||
--team <team> - Team associated with the issue (if not your default team)
|
||||
--project <project> - Name or slug ID of the project with the issue
|
||||
-s, --state <state> - Workflow state for the issue (by name or type)
|
||||
--milestone <milestone> - Name of the project milestone
|
||||
--cycle <cycle> - Cycle name, number, or 'active'
|
||||
-t, --title <title> - Title of the issue
|
||||
```
|
||||
|
||||
### comment
|
||||
|
||||
> Manage issue comments
|
||||
|
||||
```
|
||||
Usage: linear issue comment
|
||||
|
||||
Description:
|
||||
|
||||
Manage issue comments
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
|
||||
Commands:
|
||||
|
||||
add [issueId] - Add a comment to an issue or reply to a comment
|
||||
delete <commentId> - Delete a comment
|
||||
update <commentId> - Update an existing comment
|
||||
list [issueId] - List comments for an issue
|
||||
```
|
||||
|
||||
#### comment subcommands
|
||||
|
||||
##### add
|
||||
|
||||
```
|
||||
Usage: linear issue comment add [issueId]
|
||||
|
||||
Description:
|
||||
|
||||
Add a comment to an issue or reply to a comment
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-b, --body <text> - Comment body text
|
||||
--body-file <path> - Read comment body from a file (preferred for markdown content)
|
||||
-p, --parent <id> - Parent comment ID for replies
|
||||
-a, --attach <filepath> - Attach a file to the comment (can be used multiple times)
|
||||
--public - Upload attached images to a public, unauthenticated URL (default: private,
|
||||
workspace-members only)
|
||||
```
|
||||
|
||||
##### delete
|
||||
|
||||
```
|
||||
Usage: linear issue comment delete <commentId>
|
||||
|
||||
Description:
|
||||
|
||||
Delete a comment
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
```
|
||||
|
||||
##### update
|
||||
|
||||
```
|
||||
Usage: linear issue comment update <commentId>
|
||||
|
||||
Description:
|
||||
|
||||
Update an existing comment
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-b, --body <text> - New comment body text
|
||||
--body-file <path> - Read comment body from a file (preferred for markdown content)
|
||||
```
|
||||
|
||||
##### list
|
||||
|
||||
```
|
||||
Usage: linear issue comment list [issueId]
|
||||
|
||||
Description:
|
||||
|
||||
List comments for an issue
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-j, --json - Output as JSON
|
||||
```
|
||||
|
||||
### attach
|
||||
|
||||
> Attach a file to an issue
|
||||
|
||||
```
|
||||
Usage: linear issue attach <issueId> <filepath>
|
||||
|
||||
Description:
|
||||
|
||||
Attach a file to an issue
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-t, --title <title> - Custom title for the attachment
|
||||
-c, --comment <body> - Add a comment body linked to the attachment
|
||||
--public - Upload images to a public, unauthenticated URL (default: private,
|
||||
workspace-members only)
|
||||
```
|
||||
|
||||
### link
|
||||
|
||||
> Link a URL to an issue
|
||||
|
||||
```
|
||||
Usage: linear issue link <urlOrIssueId> [url]
|
||||
|
||||
Description:
|
||||
|
||||
Link a URL to an issue
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-t, --title <title> - Custom title for the link
|
||||
|
||||
Examples:
|
||||
|
||||
Link a URL to issue detected from branch linear issue link https://github.com/org/repo/pull/123
|
||||
Link a URL to a specific issue linear issue link ENG-123 https://github.com/org/repo/pull/123
|
||||
Link with a custom title linear issue link ENG-123 https://example.com --title "Design doc"
|
||||
```
|
||||
|
||||
### relation
|
||||
|
||||
> Manage issue relations (dependencies)
|
||||
@@ -568,60 +520,121 @@ Options:
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
```
|
||||
|
||||
### agent-session
|
||||
### start
|
||||
|
||||
> Manage agent sessions for an issue
|
||||
> Start working on an issue
|
||||
|
||||
```
|
||||
Usage: linear issue agent-session
|
||||
Usage: linear issue start [issueId]
|
||||
|
||||
Description:
|
||||
|
||||
Manage agent sessions for an issue
|
||||
Start working on an issue
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-A, --all-assignees - Show issues for all assignees
|
||||
-U, --unassigned - Show only unassigned issues
|
||||
-f, --from-ref <fromRef> - Git ref to create new branch from
|
||||
-b, --branch <branch> - Custom branch name to use instead of the issue identifier
|
||||
```
|
||||
|
||||
### title
|
||||
|
||||
> Print the issue title
|
||||
|
||||
```
|
||||
Usage: linear issue title [issueId]
|
||||
|
||||
Description:
|
||||
|
||||
Print the issue title
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
|
||||
Commands:
|
||||
|
||||
list [issueId] - List agent sessions for an issue
|
||||
view, v <sessionId> - View agent session details
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
```
|
||||
|
||||
#### agent-session subcommands
|
||||
### update
|
||||
|
||||
##### list
|
||||
> Update a linear issue
|
||||
|
||||
```
|
||||
Usage: linear issue agent-session list [issueId]
|
||||
Usage: linear issue update [issueId]
|
||||
|
||||
Description:
|
||||
|
||||
List agent sessions for an issue
|
||||
Update a linear issue
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-j, --json - Output as JSON
|
||||
--status <status> - Filter by session status (Values: "pending", "active", "complete", "awaitingInput",
|
||||
"error", "stale")
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-a, --assignee <assignee> - Assign the issue to 'self' or someone (by username or name)
|
||||
--unassign - Clear the issue's assignee (cannot be combined with --assignee)
|
||||
--due-date <dueDate> - Due date of the issue
|
||||
--parent <parent> - Parent issue (if any) as a team_number code
|
||||
-p, --priority <priority> - Priority of the issue (1-4, descending priority)
|
||||
--estimate <estimate> - Points estimate of the issue
|
||||
-d, --description <description> - Description of the issue
|
||||
--description-file <path> - Read description from a file (preferred for markdown content)
|
||||
-l, --label <label> - Issue label associated with the issue; replaces the issue's entire label set.
|
||||
May be repeated. Use --add-label/--remove-label to change labels incrementally.
|
||||
--add-label <label> - Add a label to the issue, keeping its existing labels. May be repeated.
|
||||
--remove-label <label> - Remove a label from the issue, keeping its other labels (does not delete the
|
||||
label from the team). May be repeated.
|
||||
--team <team> - Team associated with the issue (if not your default team)
|
||||
--project <project> - Project to assign the issue to (UUID, slug ID, or name)
|
||||
-s, --state <state> - Workflow state for the issue (by name or type)
|
||||
--milestone <milestone> - Project milestone (UUID, or name when --project is set or the issue already has
|
||||
a project)
|
||||
--cycle <cycle> - Cycle name, number, 'active'/'now', 'next', 'previous', or a relative offset
|
||||
like +1 (use --cycle=-1 for negatives). Use --clear-cycle to remove the issue
|
||||
from its cycle
|
||||
--clear-cycle - Remove the issue from its cycle
|
||||
-t, --title <title> - Title of the issue
|
||||
```
|
||||
|
||||
##### view
|
||||
### url
|
||||
|
||||
> Print the issue URL
|
||||
|
||||
```
|
||||
Usage: linear issue agent-session view <sessionId>
|
||||
Usage: linear issue url [issueId]
|
||||
|
||||
Description:
|
||||
|
||||
View agent session details
|
||||
Print the issue URL
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-j, --json - Output as JSON
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
```
|
||||
|
||||
### view
|
||||
|
||||
> View issue details (default) or open in browser/app
|
||||
|
||||
```
|
||||
Usage: linear issue view [issueId]
|
||||
|
||||
Description:
|
||||
|
||||
View issue details (default) or open in browser/app
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-w, --web - Open in web browser
|
||||
-a, --app - Open in Linear.app
|
||||
--no-comments - Exclude comments from the output
|
||||
--show-resolved-threads - Include resolved comment threads in the output
|
||||
--no-pager - Disable automatic paging for long output
|
||||
-j, --json - Output issue data as JSON
|
||||
--no-download - Keep remote URLs instead of downloading files
|
||||
```
|
||||
@@ -25,26 +25,6 @@ Commands:
|
||||
|
||||
## Subcommands
|
||||
|
||||
### list
|
||||
|
||||
> List issue labels
|
||||
|
||||
```
|
||||
Usage: linear label list
|
||||
|
||||
Description:
|
||||
|
||||
List issue labels
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--team <teamKey> - Filter by team (e.g., TC). Shows team-specific labels only.
|
||||
--workspace - Show only workspace-level labels (not team-specific)
|
||||
--all - Show all labels (both workspace and team)
|
||||
-j, --json - Output as JSON
|
||||
```
|
||||
|
||||
### create
|
||||
|
||||
> Create a new issue label
|
||||
@@ -85,3 +65,23 @@ Options:
|
||||
-t, --team <teamKey> - Team key to disambiguate labels with same name
|
||||
-f, --force - Skip confirmation prompt
|
||||
```
|
||||
|
||||
### list
|
||||
|
||||
> List issue labels
|
||||
|
||||
```
|
||||
Usage: linear label list
|
||||
|
||||
Description:
|
||||
|
||||
List issue labels
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--team <teamKey> - Filter by team (e.g., TC). Shows team-specific labels only.
|
||||
--workspace - Show only workspace-level labels (not team-specific)
|
||||
--all - Show all labels (both workspace and team)
|
||||
-j, --json - Output as JSON
|
||||
```
|
||||
@@ -18,56 +18,22 @@ Options:
|
||||
|
||||
Commands:
|
||||
|
||||
list - List milestones for a project
|
||||
view, v <milestoneId> - View milestone details
|
||||
create - Create a new project milestone
|
||||
update <id> - Update an existing project milestone
|
||||
delete <id> - Delete a project milestone
|
||||
list - List milestones for a project
|
||||
view, v <milestone> - View milestone details. By default lists the first 10 attached issues from the
|
||||
first page of 50; use --all to paginate the full set.
|
||||
create - Create a new project milestone
|
||||
update <id> - Update an existing project milestone
|
||||
delete <id> - Delete a project milestone
|
||||
```
|
||||
|
||||
## Subcommands
|
||||
|
||||
### list
|
||||
|
||||
> List milestones for a project
|
||||
|
||||
```
|
||||
Usage: linear milestone list --project <projectId>
|
||||
|
||||
Description:
|
||||
|
||||
List milestones for a project
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
--project <projectId> - Project ID (required)
|
||||
```
|
||||
|
||||
### view
|
||||
|
||||
> View milestone details
|
||||
|
||||
```
|
||||
Usage: linear milestone view <milestoneId>
|
||||
|
||||
Description:
|
||||
|
||||
View milestone details
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
```
|
||||
|
||||
### create
|
||||
|
||||
> Create a new project milestone
|
||||
|
||||
```
|
||||
Usage: linear milestone create --project <projectId> --name <name>
|
||||
Usage: linear milestone create --project <project> --name <name>
|
||||
|
||||
Description:
|
||||
|
||||
@@ -77,34 +43,12 @@ Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
--project <projectId> - Project ID (required)
|
||||
--project <project> - Project (UUID, slug ID, or name) (required)
|
||||
--name <name> - Milestone name (required)
|
||||
--description <description> - Milestone description
|
||||
--target-date <date> - Target date (YYYY-MM-DD)
|
||||
```
|
||||
|
||||
### update
|
||||
|
||||
> Update an existing project milestone
|
||||
|
||||
```
|
||||
Usage: linear milestone update <id>
|
||||
|
||||
Description:
|
||||
|
||||
Update an existing project milestone
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
--name <name> - Milestone name
|
||||
--description <description> - Milestone description
|
||||
--target-date <date> - Target date (YYYY-MM-DD)
|
||||
--sort-order <value> - Sort order relative to other milestones
|
||||
--project <projectId> - Move to a different project
|
||||
```
|
||||
|
||||
### delete
|
||||
|
||||
> Delete a project milestone
|
||||
@@ -122,3 +66,62 @@ Options:
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-f, --force - Skip confirmation prompt
|
||||
```
|
||||
|
||||
### list
|
||||
|
||||
> List milestones for a project
|
||||
|
||||
```
|
||||
Usage: linear milestone list --project <project>
|
||||
|
||||
Description:
|
||||
|
||||
List milestones for a project
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
--project <project> - Project (UUID, slug ID, or name) (required)
|
||||
```
|
||||
|
||||
### update
|
||||
|
||||
> Update an existing project milestone
|
||||
|
||||
```
|
||||
Usage: linear milestone update <id>
|
||||
|
||||
Description:
|
||||
|
||||
Update an existing project milestone
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
--name <name> - Milestone name
|
||||
--description <description> - Milestone description
|
||||
--target-date <date> - Target date (YYYY-MM-DD)
|
||||
--sort-order <value> - Sort order relative to other milestones
|
||||
--project <project> - Move to a different project (UUID, slug ID, or name)
|
||||
```
|
||||
|
||||
### view
|
||||
|
||||
> View milestone details. By default lists the first 10 attached issues from the first page of 50; use --all to paginate the full set.
|
||||
|
||||
```
|
||||
Usage: linear milestone view <milestone>
|
||||
|
||||
Description:
|
||||
|
||||
View milestone details. By default lists the first 10 attached issues from the first page of 50; use --all to paginate the full set.
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
--all - Fetch and list every issue attached to the milestone (paginates the Linear API).
|
||||
--project <project> - Project for resolving a milestone name (UUID, slug ID, or name)
|
||||
```
|
||||
@@ -74,12 +74,18 @@ echo -e "DEV-123\nDEV-124" | linear issue delete --bulk-stdin
|
||||
linear initiative archive --bulk <id1> <id2>
|
||||
```
|
||||
|
||||
## Adding Labels to Issues
|
||||
## Updating Labels on Issues
|
||||
|
||||
```bash
|
||||
# Add label to issue
|
||||
linear issue update DEV-123 --label "Bug"
|
||||
# Add a label, keeping the issue's existing labels
|
||||
linear issue update DEV-123 --add-label "Bug"
|
||||
|
||||
# Add multiple labels
|
||||
# Remove a label from this issue only (label delete removes it team-wide)
|
||||
linear issue update DEV-123 --remove-label "sprint-42"
|
||||
|
||||
# Swap labels atomically in one update
|
||||
linear issue update DEV-123 --remove-label "sprint-42" --add-label "sprint-43"
|
||||
|
||||
# Replace the entire label set with exactly these labels
|
||||
linear issue update DEV-123 --label "Bug" --label "High Priority"
|
||||
```
|
||||
@@ -27,6 +27,60 @@ Commands:
|
||||
|
||||
## Subcommands
|
||||
|
||||
### create
|
||||
|
||||
> Create a new Linear project
|
||||
|
||||
```
|
||||
Usage: linear project create
|
||||
|
||||
Description:
|
||||
|
||||
Create a new Linear project
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-n, --name <name> - Project name (required)
|
||||
-d, --description <description> - Project description (max 255 characters, enforced by Linear's API)
|
||||
-f, --description-file <path> - Read project description from file (still subject to the 255-character API
|
||||
limit)
|
||||
--content <markdown> - Project overview markdown
|
||||
--content-file <path> - Read project overview markdown from a file
|
||||
-t, --team <team> - Team key (required, can be repeated for multiple teams)
|
||||
-l, --lead <lead> - Project lead (username, email, or @me)
|
||||
-s, --status <status> - Project status (planned, started, paused, completed, canceled, backlog)
|
||||
--start-date <startDate> - Start date (YYYY-MM-DD)
|
||||
--target-date <targetDate> - Target completion date (YYYY-MM-DD)
|
||||
--priority <priority> - Project priority (none, urgent, high, medium, low)
|
||||
--label <label> - Project label associated with the project. May be repeated.
|
||||
--member <user> - Project member (username, email, display name, or @me). May be repeated.
|
||||
--icon <icon> - Project icon
|
||||
--color <color> - Project color as a HEX string
|
||||
--initiative <initiative> - Add to initiative immediately (ID, slug, or name)
|
||||
-i, --interactive - Interactive mode (default if no flags provided)
|
||||
-j, --json - Output created project as JSON
|
||||
```
|
||||
|
||||
### delete
|
||||
|
||||
> Delete (trash) a Linear project
|
||||
|
||||
```
|
||||
Usage: linear project delete <projectId>
|
||||
|
||||
Description:
|
||||
|
||||
Delete (trash) a Linear project
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-f, --force - Skip confirmation prompt
|
||||
```
|
||||
|
||||
### list
|
||||
|
||||
> List projects
|
||||
@@ -50,6 +104,33 @@ Options:
|
||||
-j, --json - Output as JSON
|
||||
```
|
||||
|
||||
### update
|
||||
|
||||
> Update a Linear project
|
||||
|
||||
```
|
||||
Usage: linear project update <projectId>
|
||||
|
||||
Description:
|
||||
|
||||
Update a Linear project
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-n, --name <name> - Project name
|
||||
-d, --description <description> - Project description (max 255 characters, enforced by Linear's API)
|
||||
-f, --description-file <path> - Read project description from file (still subject to the 255-character API
|
||||
limit)
|
||||
-s, --status <status> - Status (planned, started, paused, completed, canceled, backlog)
|
||||
-l, --lead <lead> - Project lead (username, email, or @me)
|
||||
--start-date <startDate> - Start date (YYYY-MM-DD)
|
||||
--target-date <targetDate> - Target date (YYYY-MM-DD)
|
||||
-t, --team <team> - Team key (can be repeated for multiple teams)
|
||||
--label <label> - Replace the project's labels. May be repeated to set multiple labels.
|
||||
```
|
||||
|
||||
### view
|
||||
|
||||
> View project details
|
||||
@@ -68,72 +149,3 @@ Options:
|
||||
-w, --web - Open in web browser
|
||||
-a, --app - Open in Linear.app
|
||||
```
|
||||
|
||||
### create
|
||||
|
||||
> Create a new Linear project
|
||||
|
||||
```
|
||||
Usage: linear project create
|
||||
|
||||
Description:
|
||||
|
||||
Create a new Linear project
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-n, --name <name> - Project name (required)
|
||||
-d, --description <description> - Project description
|
||||
-t, --team <team> - Team key (required, can be repeated for multiple teams)
|
||||
-l, --lead <lead> - Project lead (username, email, or @me)
|
||||
-s, --status <status> - Project status (planned, started, paused, completed, canceled, backlog)
|
||||
--start-date <startDate> - Start date (YYYY-MM-DD)
|
||||
--target-date <targetDate> - Target completion date (YYYY-MM-DD)
|
||||
--initiative <initiative> - Add to initiative immediately (ID, slug, or name)
|
||||
-i, --interactive - Interactive mode (default if no flags provided)
|
||||
-j, --json - Output created project as JSON
|
||||
```
|
||||
|
||||
### update
|
||||
|
||||
> Update a Linear project
|
||||
|
||||
```
|
||||
Usage: linear project update <projectId>
|
||||
|
||||
Description:
|
||||
|
||||
Update a Linear project
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-n, --name <name> - Project name
|
||||
-d, --description <description> - Project description
|
||||
-s, --status <status> - Status (planned, started, paused, completed, canceled, backlog)
|
||||
-l, --lead <lead> - Project lead (username, email, or @me)
|
||||
--start-date <startDate> - Start date (YYYY-MM-DD)
|
||||
--target-date <targetDate> - Target date (YYYY-MM-DD)
|
||||
-t, --team <team> - Team key (can be repeated for multiple teams)
|
||||
```
|
||||
|
||||
### delete
|
||||
|
||||
> Delete (trash) a Linear project
|
||||
|
||||
```
|
||||
Usage: linear project delete <projectId>
|
||||
|
||||
Description:
|
||||
|
||||
Delete (trash) a Linear project
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-f, --force - Skip confirmation prompt
|
||||
```
|
||||
@@ -23,11 +23,29 @@ Commands:
|
||||
list - List teams
|
||||
id - Print the configured team id
|
||||
autolinks - Configure GitHub repository autolinks for Linear issues with this team prefix
|
||||
members [teamKey] - List team members
|
||||
members [teamKey] - List team members
|
||||
states [teamKey] - List workflow states for a team
|
||||
```
|
||||
|
||||
## Subcommands
|
||||
|
||||
### autolinks
|
||||
|
||||
> Configure GitHub repository autolinks for Linear issues with this team prefix
|
||||
|
||||
```
|
||||
Usage: linear team autolinks
|
||||
|
||||
Description:
|
||||
|
||||
Configure GitHub repository autolinks for Linear issues with this team prefix
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
```
|
||||
|
||||
### create
|
||||
|
||||
> Create a linear team
|
||||
@@ -69,6 +87,23 @@ Options:
|
||||
-y, --force - Skip confirmation prompt
|
||||
```
|
||||
|
||||
### id
|
||||
|
||||
> Print the configured team id
|
||||
|
||||
```
|
||||
Usage: linear team id
|
||||
|
||||
Description:
|
||||
|
||||
Print the configured team id
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
```
|
||||
|
||||
### list
|
||||
|
||||
> List teams
|
||||
@@ -88,40 +123,6 @@ Options:
|
||||
-a, --app - Open in Linear.app
|
||||
```
|
||||
|
||||
### id
|
||||
|
||||
> Print the configured team id
|
||||
|
||||
```
|
||||
Usage: linear team id
|
||||
|
||||
Description:
|
||||
|
||||
Print the configured team id
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
```
|
||||
|
||||
### autolinks
|
||||
|
||||
> Configure GitHub repository autolinks for Linear issues with this team prefix
|
||||
|
||||
```
|
||||
Usage: linear team autolinks
|
||||
|
||||
Description:
|
||||
|
||||
Configure GitHub repository autolinks for Linear issues with this team prefix
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
```
|
||||
|
||||
### members
|
||||
|
||||
> List team members
|
||||
@@ -137,5 +138,24 @@ Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-a, --all - Include inactive members
|
||||
-a, --all - Include inactive members
|
||||
-j, --json - Output as JSON
|
||||
```
|
||||
|
||||
### states
|
||||
|
||||
> List workflow states for a team
|
||||
|
||||
```
|
||||
Usage: linear team states [teamKey]
|
||||
|
||||
Description:
|
||||
|
||||
List workflow states for a team
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help - Show this help.
|
||||
--workspace <slug> - Target workspace (uses credentials)
|
||||
-j, --json - Output as JSON
|
||||
```
|
||||
Reference in new issue
Block a user