linear-cli 0.3.21

A powerful CLI for Linear.app - manage issues, projects, cycles, and more from your terminal
---
name: linear-project-updates
description: Manage project status updates - create, list, archive. Use when posting or viewing project health updates.
allowed-tools: Bash
---

# Project Updates

```bash
# List updates for a project
linear-cli pu list "My Project"
linear-cli pu list "My Project" --output json

# Get update details
linear-cli pu get UPDATE_ID

# Create a project update
linear-cli pu create "My Project" -b "On track this sprint"
linear-cli pu create "My Project" -b "Blocked on API" --health atRisk

# Update an existing update
linear-cli pu update UPDATE_ID -b "Updated status"

# Archive/unarchive
linear-cli pu archive UPDATE_ID
linear-cli pu unarchive UPDATE_ID
```

## Health Status

| Value | Meaning |
|-------|---------|
| `onTrack` | Project is on track (green) |
| `atRisk` | Project is at risk (yellow) |
| `offTrack` | Project is off track (red) |

## Flags

| Flag | Purpose |
|------|---------|
| `-b BODY` | Update body text |
| `--health STATUS` | Health status |
| `--output json` | JSON output |

## Exit Codes

`0`=Success, `1`=Error, `2`=Not found, `3`=Auth error