About linear-projects
A skill for working with Linear projects through `linear-cli`. It supports listing and retrieving projects, including archived projects and saved views, and exposes options for project metadata and status.
Key features
- 01List projects, including archived
- 02Filter by saved view
- 03Get or open a project
- 04Set project metadata and status
- 05Use JSON or ID-only output
Use cases
- 01Review active projects using a saved view
- 02Find archived projects
- 03Set a project lead, priority, or dates
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/linear-projectsin Claude Code to confirm it loaded.
Details
From the project READMEProjects
# List projects
linear-cli p list # All projects
linear-cli p list --archived # Include archived
linear-cli p list --view "Active" # Apply saved view
# Get project
linear-cli p get PROJECT_ID
linear-cli p open PROJECT_ID # Open in browser
# Create project (full API fields)
linear-cli p create "Q1 Roadmap" -t ENG
linear-cli p create "Feature" -t ENG --icon "🚀" --priority 1 \
--start-date 2025-01-01 --target-date 2025-03-31 \
--lead USER_ID --status planned --content "Project description"
# Update project
linear-cli p update PROJECT_ID --name "New Name" --status completed
linear-cli p update PROJECT_ID --lead USER_ID --priority 2
# Archive/unarchive
linear-cli p archive PROJECT_ID
linear-cli p unarchive PROJECT_ID
# Labels
linear-cli p add-labels PROJECT_ID -l label1 -l label2
linear-cli p remove-labels PROJECT_ID -l label1
linear-cli p set-labels PROJECT_ID -l label1 -l label2
# Members
linear-cli p members PROJECT_ID
# Delete
linear-cli p delete PROJECT_ID --force
Flags
| Flag | Purpose |
|---|---|
--icon EMOJI | Project icon |
--priority N | Priority (1=urgent, 4=low) |
--start-date DATE | Start date |
--target-date DATE | Target date |
--lead USER | Project lead |
--status STATE | Project status |
--id-only | Return ID only |
--output json | JSON output |
Comments
Markdown supported