Menu
Manage project status updates - create, list, archive. Use when posting or viewing project health updates.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Execute raw GraphQL queries and mutations against the Linear API. Use for advanced operations not covered by other commands.
Manage issue attachments - link URLs, create, update, delete. Use when attaching files or links to issues.
Manage issue comments - list, create, update, delete. Use when reading or posting comments on issues.
Configure linear-cli - auth (API key + OAuth), workspaces, diagnostics, setup wizard.
Manage Linear sprint cycles - list, create, update, delete, complete. Use when managing cycles.
Mark the current branch's issue as Done. Use as a quick shortcut to close the issue you're working on.
| name | linear-project-updates |
| description | Manage project status updates - create, list, archive. Use when posting or viewing project health updates. |
| allowed-tools | 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
| Value | Meaning |
|---|---|
onTrack | Project is on track (green) |
atRisk | Project is at risk (yellow) |
offTrack | Project is off track (red) |
| Flag | Purpose |
|---|---|
-b BODY | Update body text |
--health STATUS | Health status |
--output json | JSON output |
0=Success, 1=Error, 2=Not found, 3=Auth error