### Listing Workspaces Example

Source: https://github.com/schpet/linear-cli/blob/main/docs/authentication.md

Example output of the `linear auth list` command, showing configured workspaces and indicating the default.

```bash
$ linear auth list
  WORKSPACE    ORG NAME      USER
* acme         Acme Corp     Jane Developer <jane@acme.com>
  side-project Side Project  Jane Developer <jane@example.com>
```

--------------------------------

### Install via Homebrew

Source: https://github.com/schpet/linear-cli/blob/main/README.md

Install the linear CLI using Homebrew.

```bash
brew install schpet/tap/linear
```

--------------------------------

### Install via Deno (JSR)

Source: https://github.com/schpet/linear-cli/blob/main/README.md

Install the linear CLI using Deno and JSR.

```bash
deno install -A --reload -f -g -n linear jsr:@schpet/linear-cli
```

--------------------------------

### Adding Workspaces Example

Source: https://github.com/schpet/linear-cli/blob/main/docs/authentication.md

Example of logging in and adding a new workspace to the Linear CLI, showing the interactive prompt and confirmation.

```bash
# first workspace becomes the default
$ linear auth login
Enter your Linear API key: ***
Logged in to workspace: Acme Corp (acme)
  User: Jane Developer <jane@acme.com>
  Set as default workspace

# add additional workspaces
$ linear auth login
Enter your Linear API key: ***
Logged in to workspace: Side Project (side-project)
  User: Jane Developer <jane@example.com>
```

--------------------------------

### GraphQL Query Example

Source: https://github.com/schpet/linear-cli/blob/main/AGENTS.md

Example of a typed GraphQL query after codegen.

```typescript
const result = await client.request(query, { teamId });
```

--------------------------------

### Local Development Setup

Source: https://github.com/schpet/linear-cli/blob/main/README.md

Steps to clone the repository and set up for local development.

```bash
git clone https://github.com/schpet/linear-cli
cd linear-cli
deno task install
```

--------------------------------

### Install via npm/bun/pnpm (Dev Dependency)

Source: https://github.com/schpet/linear-cli/blob/main/README.md

Install the linear CLI as a dev dependency in your project.

```bash
npm install -D @schpet/linear-cli
# or
bun add -D @schpet/linear-cli
# or
pnpm add -D @schpet/linear-cli
```

--------------------------------

### Get issue url

Source: https://github.com/schpet/linear-cli/blob/main/docs/usage.md

Get issue url.

```bash
linear issue url TEAM-123
```

--------------------------------

### Install Linear CLI Skill via skills.sh

Source: https://github.com/schpet/linear-cli/blob/main/README.md

Instructions to install the Linear CLI skill using skills.sh.

```bash
npx skills add schpet/linear-cli
```

--------------------------------

### Switching Workspaces Example

Source: https://github.com/schpet/linear-cli/blob/main/docs/authentication.md

Demonstrates how to switch the default workspace or use the `--workspace` flag for single commands.

```bash
# set a new default
linear auth default side-project

# or use --workspace flag for a single command
linear --workspace side-project issue list
linear --workspace acme issue create --title "Bug fix"
```

--------------------------------

### Basic Commands

Source: https://github.com/schpet/linear-cli/blob/main/README.md

Common commands for setting up, listing, querying, starting, viewing, and creating issues.

```bash
linear config               # setup your repo, it writes a config file

linear issue mine           # list unstarted issues assigned to you
linear issue query --all-teams  # query issues across all teams
linear issue query --search "login bug"  # search issues in your configured team
linear issue start          # choose an issue to start, creates a branch
linear issue start ABC-123  # start a specific issue
linear issue view           # see current branch's issue as markdown
linear issue pr             # makes a PR with title/body preset, using gh cli
linear issue create         # create a new issue
```

--------------------------------

### Install Linear CLI Skill via Claude Code

Source: https://github.com/schpet/linear-cli/blob/main/README.md

Instructions to install the Linear CLI skill using Claude Code's plugin system.

```bash
# from claude code
/plugin marketplace add schpet/linear-cli
/plugin install linear-cli@linear-cli

# from bash
claude plugin marketplace add schpet/linear-cli
claude plugin install linear-cli@linear-cli

# to update
claude plugin marketplace update linear-cli
claude plugin update linear-cli@linear-cli
```

--------------------------------

### Get issue title

Source: https://github.com/schpet/linear-cli/blob/main/docs/usage.md

Get issue title.

```bash
linear issue title TEAM-123
```

--------------------------------

### Project Configuration Authentication

Source: https://github.com/schpet/linear-cli/blob/main/docs/authentication.md

Example of setting API key and workspace in a project's `.linear.toml` configuration file.

```toml
api_key = "lin_api_..."
workspace = "acme"
team_id = "ENG"
```

--------------------------------

### Run via Package Manager

Source: https://github.com/schpet/linear-cli/blob/main/README.md

How to run the linear CLI after installing it as a dev dependency.

```bash
npx linear issue list
bunx linear issue list
```

--------------------------------

### Start working on an issue

Source: https://github.com/schpet/linear-cli/blob/main/docs/usage.md

Start the next available issue. This will move the issue to "in progress" and create a git branch.

```bash
linear issue start
```

--------------------------------

### Credentials File Format

Source: https://github.com/schpet/linear-cli/blob/main/docs/authentication.md

Example TOML format for the `~/.config/linear/credentials.toml` file, which stores workspace metadata.

```toml
# ~/.config/linear/credentials.toml
default = "acme"
workspaces = ["acme", "side-project"]
```

--------------------------------

### Run linear without global installation

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/SKILL.template.md

Run the linear cli without installing it globally using npx.

```bash
npx @schpet/linear-cli --version
```

--------------------------------

### Linear CLI Help

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/commands.md

Shows how to get help for any command or subcommand in the Linear CLI.

```bash
# Get help for any command
linear <command> --help
linear <command> <subcommand> --help
```

--------------------------------

### Start a specific issue

Source: https://github.com/schpet/linear-cli/blob/main/docs/usage.md

Start a specific issue. This will move the issue to "in progress" and create a git branch.

```bash
linear issue start TEAM-123
```

--------------------------------

### Create issue using a description file

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/SKILL.template.md

Example workflow for creating an issue using a markdown file for the description.

```bash
# Write markdown to a temporary file
cat > /tmp/description.md <<'EOF'
## Summary

- First item
- Second item

## Details

This is a detailed description with proper formatting.
EOF

# Create issue using the file
linear issue create --title "My Issue" --description-file /tmp/description.md
```

--------------------------------

### Searching Issues by Text

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/SKILL.md

Example of searching for issues by text using the 'searchIssues' query with variables.

```bash
# Search issues by text
linear api --variable term=onboarding <<'GRAPHQL'
query($term: String!) { searchIssues(term: $term, first: 20) { nodes { identifier title state { name } } } }
GRAPHQL
```

--------------------------------

### GraphQL Request with Variables (Heredoc)

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/SKILL.md

Example of making a GraphQL query with variables, using a heredoc to handle potential escaping issues with non-null type markers.

```bash
# Query with variables — use heredoc to avoid escaping issues
linear api --variable teamId=abc123 <<'GRAPHQL'
query($teamId: String!) { team(id: $teamId) { name } }
GRAPHQL
```

--------------------------------

### linear issue start

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/issue.md

Start working on an issue. This command provides options for targeting a workspace, showing issues for all assignees or only unassigned issues, specifying a Git ref to create a new branch from, and setting a custom branch name.

```bash
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

```

--------------------------------

### Environment Variable Authentication

Source: https://github.com/schpet/linear-cli/blob/main/docs/authentication.md

Examples of setting the `LINEAR_API_KEY` environment variable for authentication in bash/zsh and fish shells.

```sh
# bash/zsh
export LINEAR_API_KEY="lin_api_..."

# fish
set -Ux LINEAR_API_KEY "lin_api_..."
```

--------------------------------

### Add comment using body file

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/SKILL.md

Example workflow for adding a comment using a file for the body.

```bash
linear issue comment add ENG-123 --body-file /tmp/comment.md
```

--------------------------------

### Add comment using a body file

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/SKILL.template.md

Example workflow for adding a comment using a markdown file for the body.

```bash
# Or for comments
linear issue comment add ENG-123 --body-file /tmp/comment.md
```

--------------------------------

### Get team id

Source: https://github.com/schpet/linear-cli/blob/main/docs/usage.md

Get team id derived from repository name.

```bash
linear team id
```

--------------------------------

### create

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/team.md

Create a linear team

```bash
Usage:   linear team create

Description:

  Create a linear team

Options:

  -h, --help                        - Show this help.                                          
  --workspace        <slug>         - Target workspace (uses credentials)                      
  -n, --name         <name>         - Name of the team                                         
  -d, --description  <description>  - Description of the team                                  
  -k, --key          <key>          - Team key (if not provided, will be generated from name)  
  --private                         - Make the team private                                    
  --no-interactive                  - Disable interactive prompts

```

--------------------------------

### View project details

Source: https://github.com/schpet/linear-cli/blob/main/docs/usage.md

View project details.

```bash
linear project view PROJECT-ID
```

--------------------------------

### List projects

Source: https://github.com/schpet/linear-cli/blob/main/docs/usage.md

List projects.

```bash
linear project list
```

--------------------------------

### Get issue id from current git branch

Source: https://github.com/schpet/linear-cli/blob/main/docs/usage.md

Get issue id from current git branch.

```bash
linear issue id
```

--------------------------------

### Create a team

Source: https://github.com/schpet/linear-cli/blob/main/docs/usage.md

Create a team.

```bash
linear team create
```

--------------------------------

### Global options

Source: https://github.com/schpet/linear-cli/blob/main/docs/usage.md

Most commands support these options.

```bash
- --no-pager - disable automatic paging for long output
- --no-color - disable colored output
- --help - show help for the command
```

--------------------------------

### Discover command options

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/SKILL.template.md

Discover available subcommands and flags by running --help on any command.

```bash
linear --help
linear issue --help
linear issue list --help
linear issue create --help
```

--------------------------------

### Check if linear is installed

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/SKILL.template.md

Check if the linear command is available on PATH.

```bash
linear --version
```

--------------------------------

### View issue options

Source: https://github.com/schpet/linear-cli/blob/main/docs/usage.md

Options for viewing issue details.

```bash
# Open in web browser
linear issue view TEAM-123 --web

# Open in Linear app  
linear issue view TEAM-123 --app

# Exclude comments from output
linear issue view TEAM-123 --no-comments
```

--------------------------------

### Available Commands

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/SKILL.md

Compact command list, generated from `linear --help`.

```bash
linear auth
linear auth login
linear auth logout
linear auth list
linear auth default
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 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 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 remove-project

linear initiative-update
linear initiative-update create
linear initiative-update list

linear label
linear label list
linear label create
linear label delete

linear document
linear document list
linear document view
linear document create
linear document update
linear document delete

linear config

linear schema

linear api

```

--------------------------------

### List teams

Source: https://github.com/schpet/linear-cli/blob/main/docs/usage.md

List teams.

```bash
linear team list
```

--------------------------------

### Usage

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/team.md

Manage Linear teams

```bash
Usage:   linear team

Description:

  Manage Linear teams

Options:

  -h, --help           - Show this help.                      
  --workspace  <slug>  - Target workspace (uses credentials)  

Commands:

  create                - Create a linear team                                                         
  delete     <teamKey>  - Delete a Linear team                                                         
  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

```

--------------------------------

### Write schema to a tempfile and search it

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/SKILL.template.md

Write the schema to a tempfile and then search it for specific types or fields.

```bash
linear schema -o "${TMPDIR:-/tmp}/linear-schema.graphql"
grep -i "cycle" "${TMPDIR:-/tmp}/linear-schema.graphql"
grep -A 30 "^type Issue " "${TMPDIR:-/tmp}/linear-schema.graphql"
```

--------------------------------

### Workspace Matching with Project Config

Source: https://github.com/schpet/linear-cli/blob/main/docs/authentication.md

Illustrates how the CLI uses workspace settings from `.linear.toml` to automatically select credentials.

```toml
# .linear.toml
workspace = "acme"
team_id = "ENG"
```

--------------------------------

### Common workflows

Source: https://github.com/schpet/linear-cli/blob/main/docs/usage.md

Common workflows.

```bash
# Start working on the next issue
linear issue start

# View current issue details
linear issue view

# Create and start a new bug fix
linear issue create --title "Fix login error" --label bug --start

# List high priority issues
linear issue list --sort priority

# Create a pull request for current issue
linear issue pr
```

--------------------------------

### list

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/team.md

List teams

```bash
Usage:   linear team list

Description:

  List teams

Options:

  -h, --help           - Show this help.                      
  --workspace  <slug>  - Target workspace (uses credentials)  
  -w, --web            - Open in web browser                  
  -a, --app            - Open in Linear.app

```

--------------------------------

### Piping GraphQL Output to jq

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/SKILL.md

Shows how to pipe the output of a GraphQL query to 'jq' for filtering and processing.

```bash
# Pipe to jq for filtering
linear api '{ issues(first: 5) { nodes { identifier title } } }' | jq '.data.issues.nodes[].title'
```

--------------------------------

### Complex Variables via JSON

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/SKILL.md

Example of passing complex variables to a GraphQL query using the --variables-json flag.

```bash
# Complex variables via JSON
linear api --variables-json '{"filter": {"state": {"name": {"eq": "In Progress"}}}}' <<'GRAPHQL'
query($filter: IssueFilter!) { issues(filter: $filter) { nodes { title } } }
GRAPHQL
```

--------------------------------

### Project Commands

Source: https://github.com/schpet/linear-cli/blob/main/README.md

Commands for managing projects, including listing and viewing details.

```bash
linear project list    # list projects
linear project view    # view project details
```

--------------------------------

### Create an issue with specific options

Source: https://github.com/schpet/linear-cli/blob/main/docs/usage.md

Create an issue with specific options.

```bash
# Create with title and description
linear issue create --title "Fix bug" --description "Description here"

# Create and assign to yourself
linear issue create --assignee self

# Create with priority (1-4, where 1 is highest)
linear issue create --priority 1

# Create with estimate points
linear issue create --estimate 3

# Create with labels
linear issue create --label bug --label frontend

# Create for specific team
linear issue create --team TEAM

# Create and start working on it
linear issue create --start
```

--------------------------------

### label create subcommand usage

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/label.md

Shows the usage and options for creating a new issue label.

```bash
Usage:   linear label create

Description:

  Create a new issue label

Options:

  -h, --help                        - Show this help.                                              
  --workspace        <slug>         - Target workspace (uses credentials)                          
  -n, --name         <name>         - Label name (required)                                        
  -c, --color        <color>        - Color hex code (e.g., #EB5757)                               
  -d, --description  <description>  - Label description                                            
  -t, --team         <teamKey>      - Team key for team-specific label (omit for workspace label)  
  -i, --interactive                 - Interactive mode (default if no flags provided)

```

--------------------------------

### cycle command usage

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/cycle.md

Shows the usage of the cycle command, including its description, options, and available subcommands.

```bash
Usage:   linear cycle

Description:

  Manage Linear team cycles

Options:

  -h, --help           - Show this help.                      
  --workspace  <slug>  - Target workspace (uses credentials)  

Commands:

  list                 - List cycles for a team
  view, v  <cycleRef>  - View cycle details

```

--------------------------------

### Other issue list options

Source: https://github.com/schpet/linear-cli/blob/main/docs/usage.md

Other options for listing issues.

```bash
# List issues for specific team
linear issue list --team TEAM

# Sort by priority instead of manual order
linear issue list --sort priority

# Open in web browser
linear issue list --web

# Open in Linear app
linear issue list --app
```

--------------------------------

### List issues with different states

Source: https://github.com/schpet/linear-cli/blob/main/docs/usage.md

List issues with different states.

```bash
# List started issues
linear issue list --state started

# List all issues regardless of state  
linear issue list --all-states

# List multiple states
linear issue list --state unstarted --state started
```

--------------------------------

### label command usage

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/label.md

Shows the general usage and available commands for the label subcommand.

```bash
Usage:   linear label

Description:

  Manage Linear issue labels

Options:

  -h, --help           - Show this help.                      
  --workspace  <slug>  - Target workspace (uses credentials)  

Commands:

  list                - List issue labels       
  create              - Create a new issue label
  delete  <nameOrId>  - Delete an issue label

```

--------------------------------

### View a specific issue

Source: https://github.com/schpet/linear-cli/blob/main/docs/usage.md

View a specific issue.

```bash
linear issue view TEAM-123
```

--------------------------------

### Configure Project

Source: https://github.com/schpet/linear-cli/blob/main/README.md

Configure the CLI for a specific project repository.

```bash
cd my-project-repo
linear config
```

--------------------------------

### Create an issue interactively

Source: https://github.com/schpet/linear-cli/blob/main/docs/usage.md

Create an issue interactively.

```bash
linear issue create
```

--------------------------------

### label list subcommand usage

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/label.md

Shows the usage and options for listing issue labels.

```bash
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

```

--------------------------------

### members

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/team.md

List team members

```bash
Usage:   linear team members [teamKey]

Description:

  List team members

Options:

  -h, --help           - Show this help.                      
  --workspace  <slug>  - Target workspace (uses credentials)  
  -a, --all            - Include inactive members

```

--------------------------------

### General CLI Commands

Source: https://github.com/schpet/linear-cli/blob/main/README.md

Helpful general commands for the Linear CLI.

```bash
linear --help          # show all commands
linear --version       # show version
linear config          # setup the project
linear completions     # generate shell completions
```

--------------------------------

### Make a simple GraphQL request

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/SKILL.template.md

Make a simple GraphQL request without variables, which can be passed inline.

```bash
linear api '{ viewer { id name email } }'
```

--------------------------------

### CLI Authentication Commands

Source: https://github.com/schpet/linear-cli/blob/main/docs/authentication.md

A list of available commands for managing authentication and workspaces within the Linear CLI.

```bash
linear auth login              # add a workspace (prompts for API key)
linear auth login --key <key>  # add with key directly (for scripts)
linear auth list               # list configured workspaces
linear auth default            # interactively set default workspace
linear auth default <slug>     # set default workspace directly
linear auth logout <slug>      # remove a workspace
linear auth logout <slug> -f   # remove without confirmation
linear auth whoami             # show current user and workspace
linear auth token              # print the resolved API key
```

--------------------------------

### View issue details

Source: https://github.com/schpet/linear-cli/blob/main/docs/usage.md

View the current issue (based on git branch).

```bash
linear issue view
```

--------------------------------

### List issues

Source: https://github.com/schpet/linear-cli/blob/main/docs/usage.md

List your issues (shows unstarted issues by default).

```bash
linear issue list
```

--------------------------------

### Make a GraphQL request with variables via heredoc

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/SKILL.template.md

Make a GraphQL request with variables using a heredoc to avoid escaping issues, especially for non-null type markers.

```bash
linear api --variable teamId=abc123 <<'GRAPHQL'
query($teamId: String!) { team(id: $teamId) { name } }
GRAPHQL
```

--------------------------------

### Configure the CLI

Source: https://github.com/schpet/linear-cli/blob/main/docs/usage.md

Configure the cli with your linear api token. This will interactively generate a `.linear.toml` configuration file in the repo.

```bash
linear config
```

--------------------------------

### Add Project to Initiative

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/initiative.md

Command to link a project to an initiative.

```bash
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

```

--------------------------------

### Configure github autolinks

Source: https://github.com/schpet/linear-cli/blob/main/docs/usage.md

Set up github repository autolinks for linear issues.

```bash
linear team autolinks
```

--------------------------------

### Document Commands

Source: https://github.com/schpet/linear-cli/blob/main/README.md

Commands for managing Linear documents, including listing, viewing, and creating them.

```bash
# list documents
linear document list                            # list all accessible documents
linear docs list                                # alias for document
linear document list --project <projectId>      # filter by project
linear document list --issue TC-123             # filter by issue
linear document list --json                     # output as JSON

# view a document
linear document view <slug>                     # view document rendered in terminal
linear document view <slug> --raw               # output raw markdown (for piping)
linear document view <slug> --web               # open in browser
linear document view <slug> --json              # output as JSON

# create a document
linear document create --title "My Doc" --content "# Hello"           # inline content
linear document create --title "Spec" --content-file ./spec.md        # from file
linear document create --title "Doc" --project <projectId>            # attach to project
linear document create --title "Notes" --issue TC-123                 # attach to issue
cat spec.md | linear document create --title "Spec"                   # from stdin
```

--------------------------------

### Create a github pull request

Source: https://github.com/schpet/linear-cli/blob/main/docs/usage.md

Create a github pull request.

```bash
linear issue pull-request
linear issue pr  # Short alias
```

--------------------------------

### id

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/team.md

Print the configured team id

```bash
Usage:   linear team id

Description:

  Print the configured team id

Options:

  -h, --help           - Show this help.                      
  --workspace  <slug>  - Target workspace (uses credentials)

```

--------------------------------

### Create Initiative Command

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/initiative.md

Command to create a new Linear initiative, with options for name, description, status, owner, etc.

```bash
Usage:   linear initiative create

Description:

  Create a new Linear initiative

Options:

  -h, --help                        - Show this help.                                        
  --workspace        <slug>         - Target workspace (uses credentials)                    
  -n, --name         <name>         - Initiative name (required)                             
  -d, --description  <description>  - Initiative description                                 
  -s, --status       <status>       - Status: planned, active, completed (default: planned)  
  -o, --owner        <owner>        - Owner (username, email, or @me for yourself)           
  --target-date      <targetDate>   - Target completion date (YYYY-MM-DD)                    
  -c, --color        <color>        - Color hex code (e.g., #5E6AD2)                         
  --icon             <icon>         - Icon name                                              
  -i, --interactive                 - Interactive mode (default if no flags provided)
```

--------------------------------

### Numeric and Boolean Variables in GraphQL

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/SKILL.md

Demonstrates how to pass numeric and boolean variables to a GraphQL query.

```bash
# Numeric and boolean variables
linear api --variable first=5 <<'GRAPHQL'
query($first: Int!) { issues(first: $first) { nodes { title } } }
GRAPHQL
```

--------------------------------

### List Initiatives Command

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/initiative.md

Command to list initiatives with various filtering and output options.

```bash
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
```

--------------------------------

### Create Milestone Command

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/milestone.md

Command to create a new project milestone.

```bash
Usage:   linear milestone create --project <projectId> --name <name>

Description:

  Create a new project milestone

Options:

  -h, --help                    - Show this help.                                
  --workspace    <slug>         - Target workspace (uses credentials)            
  --project      <projectId>    - Project ID                           (required)
  --name         <name>         - Milestone name                       (required)
  --description  <description>  - Milestone description                          
  --target-date  <date>         - Target date (YYYY-MM-DD)
```

--------------------------------

### Regenerate Skill Documentation

Source: https://github.com/schpet/linear-cli/blob/main/README.md

Command to regenerate skill documentation from CLI help text.

```bash
deno task generate-skill-docs
```

--------------------------------

### Linear CLI Config Usage

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/config.md

Shows the usage and options for the `linear config` command.

```bash
Usage:   linear config

Description:

  Interactively generate .linear.toml configuration

Options:

  -h, --help           - Show this help.                      
  --workspace  <slug>  - Target workspace (uses credentials) 

```

--------------------------------

### initiative-update create Usage

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/initiative-update.md

Usage information for the initiative-update create subcommand.

```bash
Usage:   linear initiative-update create <initiativeId>

Description:

  Create a new status update for an initiative

Options:

  -h, --help                   - Show this help.                            
  --workspace        <slug>    - Target workspace (uses credentials)        
  --body             <body>    - Update content (markdown)                  
  --body-file        <path>    - Read content from file                     
  --health           <health>  - Health status (onTrack, atRisk, offTrack)  
  -i, --interactive            - Interactive mode with prompts

```

--------------------------------

### cycle view subcommand usage

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/cycle.md

Shows the usage of the 'linear cycle view' subcommand, including its description and options.

```bash
Usage:   linear cycle view <cycleRef>

Description:

  View cycle details

Options:

  -h, --help           - Show this help.                      
  --workspace  <slug>  - Target workspace (uses credentials)  
  --team       <team>  - Team key (defaults to current team)

```

--------------------------------

### Project Management Commands

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/organization-features.md

Commands for listing, viewing, and creating projects, with options to associate with teams and initiatives.

```bash
# List projects
linear project list

# View project
linear project view <id>

# Create project
linear project create --name "New Feature" --team DEV
linear project create --name "Q1 Work" --team DEV --initiative "Q1 Goals"
linear project create -i  # Interactive mode
```

--------------------------------

### GraphQL request with numeric and boolean variables

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/SKILL.template.md

Make a GraphQL request with numeric and boolean variables.

```bash
linear api --variable first=5 <<'GRAPHQL'
query($first: Int!) { issues(first: $first) { nodes { title } } }
GRAPHQL
```

--------------------------------

### Linear CLI Project Usage

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/project.md

The main usage and options for the linear project command.

```bash
Usage:   linear project

Description:

  Manage Linear projects

Options:

  -h, --help           - Show this help.                      
  --workspace  <slug>  - Target workspace (uses credentials)  

Commands:

  list                  - List projects                  
  view, v  <projectId>  - View project details           
  create                - Create a new Linear project    
  update   <projectId>  - Update a Linear project        
  delete   <projectId>  - Delete (trash) a Linear project

```

--------------------------------

### Linear CLI Project View Subcommand

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/project.md

Usage and options for viewing Linear project details.

```bash
Usage:   linear project view <projectId>

Description:

  View project details

Options:

  -h, --help           - Show this help.                      
  --workspace  <slug>  - Target workspace (uses credentials)  
  -w, --web            - Open in web browser                  
  -a, --app            - Open in Linear.app

```

--------------------------------

### cycle list subcommand usage

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/cycle.md

Shows the usage of the 'linear cycle list' subcommand, including its description and options.

```bash
Usage:   linear cycle list

Description:

  List cycles for a team

Options:

  -h, --help           - Show this help.                      
  --workspace  <slug>  - Target workspace (uses credentials)  
  --team       <team>  - Team key (defaults to current team)

```

--------------------------------

### Initiative Management Commands

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/organization-features.md

Commands for listing, viewing, creating, archiving, and linking projects to initiatives.

```bash
# List initiatives (default: active only)
linear initiative list
linear initiative list --all-statuses
linear initiative list --status planned

# View initiative details
linear initiative view <id-or-slug>

# Create initiative
linear initiative create --name "Q1 Goals" --status active
linear initiative create -i  # Interactive mode

# Archive/unarchive
linear initiative archive <id>
linear initiative unarchive <id>

# Link projects to initiatives
linear initiative add-project <initiative> <project>
linear initiative remove-project <initiative> <project>
```

--------------------------------

### Search issues by text using GraphQL

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/SKILL.template.md

Search for issues by text using a GraphQL query with variables passed via heredoc.

```bash
linear api --variable term=onboarding <<'GRAPHQL'
query($term: String!) { searchIssues(term: $term, first: 20) { nodes { identifier title state { name } } } }
GRAPHQL
```

--------------------------------

### View Initiative Command

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/initiative.md

Command to view details of a specific initiative.

```bash
Usage:   linear initiative view <initiativeId>

Description:

  View initiative details

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
```

--------------------------------

### Initiative CLI Usage

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/initiative.md

The main usage command for managing Linear initiatives.

```bash
Usage:   linear initiative

Description:

  Manage Linear initiatives

Options:

  -h, --help           - Show this help.                      
  --workspace  <slug>  - Target workspace (uses credentials)  

Commands:

  list, ls                                - List initiatives                      
  view, v         <initiativeId>          - View initiative details               
  create                                  - Create a new Linear initiative        
  archive         [initiativeId]          - Archive a Linear initiative           
  update          <initiativeId>          - Update a Linear initiative            
  unarchive       <initiativeId>          - Unarchive a Linear initiative           
  delete          [initiativeId]          - Permanently delete a Linear initiative
  add-project     <initiative> <project>  - Link a project to an initiative       
  remove-project  <initiative> <project>  - Unlink a project from an initiative
```

--------------------------------

### Linear CLI Document Create Subcommand

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/document.md

Usage details for the 'create' subcommand to create a new document, including options for title, content, and project/issue attachment.

```bash
Usage:   linear document create

Description:

  Create a new document

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)                     
  -i, --interactive              - Interactive mode with prompts
```

--------------------------------

### List team members

Source: https://github.com/schpet/linear-cli/blob/main/docs/usage.md

List members of your default team.

```bash
linear team members
```

--------------------------------

### Linear CLI Project List Subcommand

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/project.md

Usage and options for listing Linear projects.

```bash
Usage:   linear project list

Description:

  List projects

Options:

  -h, --help             - Show this help.                      
  --workspace  <slug>    - Target workspace (uses credentials)  
  --team       <team>    - Filter by team key                   
  --all-teams            - Show projects from all teams         
  --status     <status>  - Filter by status name                
  -w, --web              - Open in web browser                  
  -a, --app              - Open in Linear.app                   
  -j, --json             - Output as JSON

```

--------------------------------

### Linear CLI Auth List Subcommand

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/auth.md

Usage and options for the 'linear auth list' subcommand to list configured workspaces.

```bash
Usage:   linear auth list

Description:

  List configured workspaces

Options:

  -h, --help           - Show this help.                      
  --workspace  <slug>  - Target workspace (uses credentials)

```

--------------------------------

### Linear CLI Project Create Subcommand

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/project.md

Usage and options for creating a new Linear project.

```bash
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

```

--------------------------------

### autolinks

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/team.md

Configure GitHub repository autolinks for Linear issues with this team prefix

```bash
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)

```

--------------------------------

### Linear CLI Auth Migrate Subcommand

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/auth.md

Usage and options for the 'linear auth migrate' subcommand to migrate plaintext credentials to the system keyring.

```bash
Usage:   linear auth migrate

Description:

  Migrate plaintext credentials to system keyring

Options:

  -h, --help           - Show this help.                      
  --workspace  <slug>  - Target workspace (uses credentials)

```

--------------------------------

### Authenticate CLI

Source: https://github.com/schpet/linear-cli/blob/main/README.md

Authenticate the CLI with your Linear account using an API key.

```bash
linear auth login
```

--------------------------------

### List Milestones Command

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/milestone.md

Command to list milestones for a specific project.

```bash
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)
```

--------------------------------

### GraphQL API Request CLI

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/api.md

Command-line interface for making raw GraphQL API requests to Linear.

```bash
Usage:   linear api [query]

Description:

  Make a raw GraphQL API request

Options:

  -h, --help                    - Show this help.                                                                  
  --workspace       <slug>      - Target workspace (uses credentials)                                              
  --variable        <variable>  - Variable in key=value format (coerces booleans, numbers, null; @file reads from  
                                  path)                                                                            
  --variables-json  <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)
```

--------------------------------

### Linear CLI Auth Usage

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/auth.md

The main usage and options for the 'linear auth' command, including its subcommands.

```bash
Usage:   linear auth

Description:

  Manage Linear authentication

Options:

  -h, --help           - Show this help.                      
  --workspace  <slug>  - Target workspace (uses credentials)  

Commands:

  login                 - Add a workspace credential                     
  logout   [workspace]  - Remove a workspace credential                  
  list                  - List configured workspaces                     
  default  [workspace]  - Set the default workspace                      
  token                 - Print the configured API token                 
  whoami                - Print information about the authenticated user 
  migrate               - Migrate plaintext credentials to system keyring

```

--------------------------------

### agent-session command

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/issue.md

Usage and options for the agent-session command.

```bash
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

```

--------------------------------

### Code Formatting Command

Source: https://github.com/schpet/linear-cli/blob/main/README.md

Command to format code using Deno's built-in formatter.

```bash
deno fmt
```

--------------------------------

### List Comments

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/issue.md

List comments for an issue.

```bash
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
```

--------------------------------

### Milestone CLI Usage

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/milestone.md

This is the main usage command for managing Linear project milestones.

```bash
Usage:   linear milestone

Description:

  Manage Linear project milestones

Options:

  -h, --help           - Show this help.                      
  --workspace  <slug>  - Target workspace (uses credentials)  

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
```

--------------------------------

### Document Management Commands

Source: https://github.com/schpet/linear-cli/blob/main/README.md

Commands for updating and deleting documents.

```bash
linear document update <slug> --title "New Title"                     # update title
linear document update <slug> --content-file ./updated.md             # update content
linear document update <slug> --edit                                  # open in $EDITOR

# delete a document
linear document delete <slug>                   # soft delete (move to trash)
linear document delete <slug> --permanent       # permanent delete
linear document delete --bulk <slug1> <slug2>   # bulk delete
```

--------------------------------

### agent-session view subcommand

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/issue.md

Usage and options for the agent-session view subcommand.

```bash
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

```

--------------------------------

### linear issue describe

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/issue.md

Print the issue title and Linear-issue trailer. Options include targeting a workspace and using 'References' instead of 'Fixes' for the Linear issue link.

```bash
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

```

--------------------------------

### Linear CLI Auth Token Subcommand

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/auth.md

Usage and options for the 'linear auth token' subcommand to print the configured API token.

```bash
Usage:   linear auth token

Description:

  Print the configured API token

Options:

  -h, --help           - Show this help.                      
  --workspace  <slug>  - Target workspace (uses credentials)

```

--------------------------------

### agent-session list subcommand

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/issue.md

Usage and options for the agent-session list subcommand.

```bash
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")

```

--------------------------------

### List Issue Relations

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/issue.md

List relations for an issue.

```bash
Usage:   linear issue relation list [issueId]

Description:

  List relations for an issue

Options:

  -h, --help           - Show this help.                      
  --workspace  <slug>  - Target workspace (uses credentials)
```

--------------------------------

### GraphQL request with complex variables via JSON

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/SKILL.template.md

Make a GraphQL request with complex variables passed as a JSON string.

```bash
linear api --variables-json '{"filter": {"state": {"name": {"eq": "In Progress"}}}}' <<'GRAPHQL'
query($filter: IssueFilter!) { issues(filter: $filter) { nodes { title } } }
GRAPHQL
```

--------------------------------

### Issue Commands

Source: https://github.com/schpet/linear-cli/blob/main/README.md

Commands for managing issues, including viewing, creating, updating, and deleting them, as well as managing comments and PRs.

```bash
linear issue view      # view current issue details in terminal
linear issue view ABC-123
linear issue view 123
linear issue view -w   # open issue in web browser
linear issue view -a   # open issue in Linear.app
linear issue id        # prints the issue id from current branch (e.g., "ENG-123")
linear issue title     # prints just the issue title
linear issue url       # prints the Linear.app URL for the issue
linear issue pr        # creates a GitHub PR with issue details via `gh pr create`
linear issue list      # list your issues in a table view (supports -s/--state and --sort)
linear issue list --project "My Project" --milestone "Phase 1"  # filter by milestone
linear issue list -w   # open issue list in web browser
linear issue list -a   # open issue list in Linear.app
linear issue query --search "login bug"  # search issues by text in your configured team
linear issue query --search "oauth timeout" --team ENG --json  # structured search output for agents
linear issue query --all-teams --json --limit 0  # export all issues as JSON
linear issue start     # create/switch to issue branch and mark as started
linear issue create    # create a new issue (interactive prompts)
linear issue create -t "title" -d "description"  # create with flags
linear issue create --project "My Project" --milestone "Phase 1"  # create with milestone
linear issue update    # update an issue (interactive prompts)
linear issue update ENG-123 --milestone "Phase 2"  # set milestone on existing issue
linear issue delete    # delete an issue
linear issue comment list          # list comments on current issue
linear issue comment add           # add a comment to current issue
linear issue comment add -p <id>   # reply to a specific comment
linear issue comment update <id>   # update a comment
linear issue commits               # show all commits for an issue (jj only)
```

--------------------------------

### initiative-update list Usage

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/initiative-update.md

Usage information for the initiative-update list subcommand.

```bash
Usage:   linear initiative-update list <initiativeId>

Description:

  List status updates for an initiative

Options:

  -h, --help            - Show this help.                                   
  --workspace  <slug>   - Target workspace (uses credentials)               
  -j, --json            - Output as JSON                                    
  --limit      <limit>  - Limit results                        (Default: 10)

```

--------------------------------

### Generate shell completions

Source: https://github.com/schpet/linear-cli/blob/main/docs/usage.md

Generate shell completions for better command-line experience.

```bash
# For bash
source <(linear completions bash)

# For zsh  
source <(linear completions zsh)

# For fish
linear completions fish | source
```

--------------------------------

### Team Commands

Source: https://github.com/schpet/linear-cli/blob/main/README.md

Commands for managing teams, including listing, creating, and configuring them.

```bash
linear team list       # list teams
linear team id         # print out the team id (e.g. for scripts)
linear team members    # list team members
linear team create     # create a new team
linear team autolinks  # configure GitHub repository autolinks for Linear issues
```

--------------------------------

### Usage

Source: https://github.com/schpet/linear-cli/blob/main/skills/linear-cli/references/schema.md

Prints the GraphQL schema to stdout. Supports options for targeting a workspace, outputting as JSON, and writing to a file.

```bash
Usage:   linear schema

Description:

  Print the GraphQL schema to stdout

Options:

  -h, --help            - Show this help.                                     
  --workspace   <slug>  - Target workspace (uses credentials)                 
  --json                - Output as JSON introspection result instead of SDL  
  -o, --output  <file>  - Write schema to file instead of stdout
```