mirror of
https://github.com/prdlk/dotfiles.git
synced 2026-11-03 03:37:36 +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
@@ -25,6 +25,70 @@ npx @schpet/linear-cli --version
|
||||
All subsequent commands can be prefixed with `npx @schpet/linear-cli` in place of `linear`. Otherwise, follow the install instructions at:\
|
||||
https://github.com/schpet/linear-cli?tab=readme-ov-file#install
|
||||
|
||||
## Common Tasks
|
||||
|
||||
Copy-pasteable recipes for the most frequent flows. Prefer these dedicated commands over `linear api` — reach for the GraphQL fallback only when no dedicated command or flag covers the operation.
|
||||
|
||||
### Query issues with filters
|
||||
|
||||
`issue query` searches across all assignees and supports structured filters that can be combined:
|
||||
|
||||
```bash
|
||||
linear issue query --team ENG --state started --json
|
||||
linear issue query --project "Mobile App" --state backlog --state triage --unassigned
|
||||
linear issue query --assignee sam --label bug --updated-after 2026-01-01
|
||||
```
|
||||
|
||||
Note: `linear issue list` is an alias of `issue mine` and only shows _your_ issues — use `issue query` for anything scoped to other people or a whole team/project.
|
||||
|
||||
### List my issues
|
||||
|
||||
```bash
|
||||
linear issue mine --state started --sort priority
|
||||
```
|
||||
|
||||
### Create an issue
|
||||
|
||||
```bash
|
||||
linear issue create --team ENG --title "Fix login redirect" \
|
||||
--description-file ./description.md --no-interactive
|
||||
```
|
||||
|
||||
Write multi-line markdown to a file and pass `--description-file` (see the markdown section below); `--no-interactive` avoids prompts in scripted use.
|
||||
|
||||
### Update an issue's state, assignee, or labels
|
||||
|
||||
```bash
|
||||
linear issue update ENG-123 --state "In Review" --assignee sam
|
||||
linear issue update ENG-123 --unassign
|
||||
linear issue update ENG-123 --add-label security # add, keep existing labels
|
||||
linear issue update ENG-123 --remove-label sprint-42 # detach; does not delete the label
|
||||
linear issue update ENG-123 --remove-label sprint-42 --add-label sprint-43 # atomic swap
|
||||
linear issue update ENG-123 --label infra --label security # replaces the label set
|
||||
```
|
||||
|
||||
### Add a comment
|
||||
|
||||
```bash
|
||||
linear issue comment add ENG-123 --body-file ./comment.md
|
||||
```
|
||||
|
||||
### Attach an image or screenshot so it is visible inline
|
||||
|
||||
```bash
|
||||
linear issue comment add ENG-123 --attach ./screenshot.png
|
||||
```
|
||||
|
||||
This uploads the image and embeds it in a comment, where Linear renders it inline. Do not use `linear issue attach` when the image must be visible: that command creates a sidebar link attachment and does not render images inline.
|
||||
|
||||
### View an issue / get its URL
|
||||
|
||||
```bash
|
||||
linear issue view ENG-123 # details incl. comments
|
||||
linear issue view ENG-123 --json # structured output
|
||||
linear issue url ENG-123 # print just the URL
|
||||
```
|
||||
|
||||
## Best Practices for Markdown Content
|
||||
|
||||
When working with issue descriptions or comment bodies that contain markdown, **always prefer using file-based flags** instead of passing content as command-line arguments:
|
||||
@@ -68,124 +132,129 @@ linear issue comment add ENG-123 --body-file /tmp/comment.md
|
||||
Compact command list, generated from `linear --help`:
|
||||
|
||||
```bash
|
||||
linear api
|
||||
|
||||
linear auth
|
||||
linear auth default
|
||||
linear auth list
|
||||
linear auth login
|
||||
linear auth logout
|
||||
linear auth list
|
||||
linear auth default
|
||||
linear auth migrate
|
||||
linear auth token
|
||||
linear auth whoami
|
||||
linear auth migrate
|
||||
|
||||
linear issue
|
||||
linear issue id
|
||||
linear issue mine
|
||||
linear issue query
|
||||
linear issue title
|
||||
linear issue start
|
||||
linear issue view
|
||||
linear issue url
|
||||
linear issue describe
|
||||
linear issue commits
|
||||
linear issue pull-request
|
||||
linear issue delete
|
||||
linear issue create
|
||||
linear issue update
|
||||
linear issue comment
|
||||
linear issue comment add
|
||||
linear issue comment delete
|
||||
linear issue comment update
|
||||
linear issue comment list
|
||||
linear issue attach
|
||||
linear issue link
|
||||
linear issue relation
|
||||
linear issue relation add
|
||||
linear issue relation delete
|
||||
linear issue relation list
|
||||
linear issue agent-session
|
||||
linear issue agent-session list
|
||||
linear issue agent-session view
|
||||
|
||||
linear team
|
||||
linear team create
|
||||
linear team delete
|
||||
linear team list
|
||||
linear team id
|
||||
linear team autolinks
|
||||
linear team members
|
||||
|
||||
linear project
|
||||
linear project list
|
||||
linear project view
|
||||
linear project create
|
||||
linear project update
|
||||
linear project delete
|
||||
|
||||
linear project-update
|
||||
linear project-update create
|
||||
linear project-update list
|
||||
linear config
|
||||
|
||||
linear cycle
|
||||
linear cycle list
|
||||
linear cycle view
|
||||
|
||||
linear milestone
|
||||
linear milestone list
|
||||
linear milestone view
|
||||
linear milestone create
|
||||
linear milestone update
|
||||
linear milestone delete
|
||||
linear document
|
||||
linear document create
|
||||
linear document delete
|
||||
linear document list
|
||||
linear document update
|
||||
linear document view
|
||||
|
||||
linear initiative
|
||||
linear initiative list
|
||||
linear initiative view
|
||||
linear initiative create
|
||||
linear initiative archive
|
||||
linear initiative update
|
||||
linear initiative unarchive
|
||||
linear initiative delete
|
||||
linear initiative add-project
|
||||
linear initiative archive
|
||||
linear initiative create
|
||||
linear initiative delete
|
||||
linear initiative list
|
||||
linear initiative remove-project
|
||||
linear initiative unarchive
|
||||
linear initiative update
|
||||
linear initiative view
|
||||
|
||||
linear initiative-update
|
||||
linear initiative-update create
|
||||
linear initiative-update list
|
||||
|
||||
linear issue
|
||||
linear issue agent-session
|
||||
linear issue agent-session list
|
||||
linear issue agent-session view
|
||||
linear issue attach
|
||||
linear issue comment
|
||||
linear issue comment add
|
||||
linear issue comment delete
|
||||
linear issue comment list
|
||||
linear issue comment update
|
||||
linear issue commits
|
||||
linear issue create
|
||||
linear issue delete
|
||||
linear issue describe
|
||||
linear issue id
|
||||
linear issue link
|
||||
linear issue mine
|
||||
linear issue pull-request
|
||||
linear issue query
|
||||
linear issue relation
|
||||
linear issue relation add
|
||||
linear issue relation delete
|
||||
linear issue relation list
|
||||
linear issue start
|
||||
linear issue title
|
||||
linear issue update
|
||||
linear issue url
|
||||
linear issue view
|
||||
|
||||
linear label
|
||||
linear label list
|
||||
linear label create
|
||||
linear label delete
|
||||
linear label list
|
||||
|
||||
linear document
|
||||
linear document list
|
||||
linear document view
|
||||
linear document create
|
||||
linear document update
|
||||
linear document delete
|
||||
linear milestone
|
||||
linear milestone create
|
||||
linear milestone delete
|
||||
linear milestone list
|
||||
linear milestone update
|
||||
linear milestone view
|
||||
|
||||
linear config
|
||||
linear project
|
||||
linear project create
|
||||
linear project delete
|
||||
linear project list
|
||||
linear project update
|
||||
linear project view
|
||||
|
||||
linear project-update
|
||||
linear project-update create
|
||||
linear project-update list
|
||||
|
||||
linear schema
|
||||
|
||||
linear api
|
||||
linear team
|
||||
linear team autolinks
|
||||
linear team create
|
||||
linear team delete
|
||||
linear team id
|
||||
linear team list
|
||||
linear team members
|
||||
linear team states
|
||||
|
||||
linear user
|
||||
linear user list
|
||||
```
|
||||
|
||||
## Reference Documentation
|
||||
|
||||
- [api](references/api.md) - Make a raw GraphQL API request
|
||||
- [auth](references/auth.md) - Manage Linear authentication
|
||||
- [issue](references/issue.md) - Manage Linear issues
|
||||
- [team](references/team.md) - Manage Linear teams
|
||||
- [project](references/project.md) - Manage Linear projects
|
||||
- [project-update](references/project-update.md) - Manage project status updates
|
||||
- [config](references/config.md) - Interactively generate .linear.toml configuration
|
||||
- [cycle](references/cycle.md) - Manage Linear team cycles
|
||||
- [milestone](references/milestone.md) - Manage Linear project milestones
|
||||
- [document](references/document.md) - Manage Linear documents
|
||||
- [initiative](references/initiative.md) - Manage Linear initiatives
|
||||
- [initiative-update](references/initiative-update.md) - Manage initiative status updates (timeline posts)
|
||||
- [issue](references/issue.md) - Manage Linear issues
|
||||
- [label](references/label.md) - Manage Linear issue labels
|
||||
- [document](references/document.md) - Manage Linear documents
|
||||
- [config](references/config.md) - Interactively generate .linear.toml configuration
|
||||
- [milestone](references/milestone.md) - Manage Linear project milestones
|
||||
- [project](references/project.md) - Manage Linear projects
|
||||
- [project-update](references/project-update.md) - Manage project status updates
|
||||
- [schema](references/schema.md) - Print the GraphQL schema to stdout
|
||||
- [api](references/api.md) - Make a raw GraphQL API request
|
||||
- [team](references/team.md) - Manage Linear teams
|
||||
- [user](references/user.md) - Manage Linear users
|
||||
|
||||
For curated examples of organization features (initiatives, labels, projects, bulk operations), see [organization-features](references/organization-features.md).
|
||||
|
||||
@@ -204,7 +273,7 @@ Each command has detailed help output describing all available flags and options
|
||||
|
||||
Some commands have required flags that aren't obvious. Notable examples:
|
||||
|
||||
- `issue list` requires a sort order — provide it via `--sort` (valid values: `manual`, `priority`), the `issue_sort` config option, or the `LINEAR_ISSUE_SORT` env var. Also requires `--team <key>` unless the team can be inferred from the directory — if unknown, run `linear team list` first.
|
||||
- `issue list` sorts by priority by default — override via `--sort` (valid values: `manual`, `priority`), the `issue_sort` config option, or the `LINEAR_ISSUE_SORT` env var. Requires `--team <key>` unless the team can be inferred from the directory — if unknown, run `linear team list` first.
|
||||
- `--no-pager` is only supported on `issue list` — passing it to other commands like `project list` will error.
|
||||
|
||||
## Using the Linear GraphQL API Directly
|
||||
|
||||
Reference in new issue
Block a user