# initiative

> Manage Linear initiatives

## Usage

```
Usage:   linear initiative

Description:

  Manage Linear initiatives

Options:

  -h, --help                  - Show this help.                                                      
  -w, --workspace  <slug>     - Target workspace (uses credentials)                                  
  --profile        <profile>  - Execution profile override (agent-safe default, human-debug opt-in)  

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

## Subcommands

### list

> List initiatives

```
Usage:   linear initiative list

Description:

  List initiatives

Options:

  -h, --help                  - Show this help.                                                      
  -w, --workspace  <slug>     - Target workspace (uses credentials)                                  
  --profile        <profile>  - Execution profile override (agent-safe default, human-debug opt-in)  
  -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                                         
  --no-pager                  - Disable automatic paging for long output                             

Examples:

  List initiatives as JSON linear initiative list --json
```

### view

> View initiative details

```
Usage:   linear initiative view <initiativeId>

Description:

  View initiative details

Options:

  -h, --help                  - Show this help.                                                      
  -w, --workspace  <slug>     - Target workspace (uses credentials)                                  
  --profile        <profile>  - Execution profile override (agent-safe default, human-debug opt-in)  
  -w, --web                   - Open in web browser                                                  
  -a, --app                   - Open in Linear.app                                                   
  -j, --json                  - Output as JSON                                                       

Examples:

  View an initiative as JSON linear initiative view initiative-slug --json
```

### create

> Create a new Linear initiative

```
Usage:   linear initiative create

Description:

  Create a new Linear initiative

Options:

  -h, --help                        - Show this help.                                                      
  -w, --workspace    <slug>         - Target workspace (uses credentials)                                  
  --profile          <profile>      - Execution profile override (agent-safe default, human-debug opt-in)  
  -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                 - Enable interactive prompts
```

### archive

> Archive a Linear initiative

```
Usage:   linear initiative archive [initiativeId]

Description:

  Archive a Linear initiative

Options:

  -h, --help                    - Show this help.                                                      
  -w, --workspace    <slug>     - Target workspace (uses credentials)                                  
  --profile          <profile>  - Execution profile override (agent-safe default, human-debug opt-in)  
  -i, --interactive             - Enable interactive confirmation                                      
  -y, --yes                     - Skip confirmation prompt                                             
  --force                       - Deprecated alias for --yes                                           
  --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
```

### update

> Update a Linear initiative

```
Usage:   linear initiative update <initiativeId>

Description:

  Update a Linear initiative

Options:

  -h, --help                        - Show this help.                                                      
  -w, --workspace    <slug>         - Target workspace (uses credentials)                                  
  --profile          <profile>      - Execution profile override (agent-safe default, human-debug opt-in)  
  -n, --name         <name>         - New name for the initiative                                          
  -d, --description  <description>  - New description                                                      
  --status           <status>       - New status (planned, active, completed, paused)                      
  --owner            <owner>        - New owner (username, email, or @me)                                  
  --target-date      <targetDate>   - Target completion date (YYYY-MM-DD)                                  
  --color            <color>        - Initiative color (hex, e.g., #5E6AD2)                                
  --icon             <icon>         - Initiative icon name                                                 
  -i, --interactive                 - Interactive mode for updates
```

### unarchive

> Unarchive a Linear initiative

```
Usage:   linear initiative unarchive <initiativeId>

Description:

  Unarchive a Linear initiative

Options:

  -h, --help                    - Show this help.                                                      
  -w, --workspace    <slug>     - Target workspace (uses credentials)                                  
  --profile          <profile>  - Execution profile override (agent-safe default, human-debug opt-in)  
  -i, --interactive             - Enable interactive confirmation                                      
  -y, --yes                     - Skip confirmation prompt                                             
  --force                       - Deprecated alias for --yes
```

### delete

> Permanently delete a Linear initiative

```
Usage:   linear initiative delete [initiativeId]

Description:

  Permanently delete a Linear initiative

Options:

  -h, --help                    - Show this help.                                                      
  -w, --workspace    <slug>     - Target workspace (uses credentials)                                  
  --profile          <profile>  - Execution profile override (agent-safe default, human-debug opt-in)  
  -i, --interactive             - Enable interactive confirmation                                      
  -y, --yes                     - Skip confirmation prompt                                             
  --force                       - Deprecated alias for --yes                                           
  --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.                                                      
  -w, --workspace  <slug>       - Target workspace (uses credentials)                                  
  --profile        <profile>    - Execution profile override (agent-safe default, human-debug opt-in)  
  --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.                                                      
  -w, --workspace    <slug>     - Target workspace (uses credentials)                                  
  --profile          <profile>  - Execution profile override (agent-safe default, human-debug opt-in)  
  -i, --interactive             - Enable interactive confirmation                                      
  -y, --yes                     - Skip confirmation prompt                                             
  --force                       - Deprecated alias for --yes
```