Menu
Manage Linear projects - full CRUD with labels, members, archive. Use when managing projects.
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-projects |
| description | Manage Linear projects - full CRUD with labels, members, archive. Use when managing projects. |
| allowed-tools | Bash |
# 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
| 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 |