Linear CLI (linctl)
Manage Linear issues, projects, teams, and comments via the linctl CLI.
Critical Rules
- •Always use
--jsonflag for all read operations - •Default filter is 6 months - use
--newer-than all_timeto see older items - •Completed/canceled items are hidden by default - use
--include-completedto see them - •Use team keys (e.g.,
ENG), not display names
Quick Command Reference
bash
# Issues linctl issue list --json linctl issue list --assignee me --json linctl issue get LIN-123 --json linctl issue create --title "Title" --team ENG linctl issue update LIN-123 --state "In Progress" linctl issue assign LIN-123 # Teams linctl team list --json linctl team get ENG --json linctl team members ENG --json # Projects linctl project list --json linctl project get <uuid> --json # Comments linctl comment list LIN-123 --json linctl comment create LIN-123 --body "Text" # Users linctl user list --json linctl user me --json linctl whoami
Detailed Documentation
- •Issues - Creating, updating, assigning, filtering, sub-issues, and workflows
- •Projects - Project tracking, progress, states, and team associations
- •Teams - Team management, members, roles, and organization
- •Comments - Adding comments, mentions, and discussion workflows
- •Filtering & Sorting - Time-based filters, sorting options, and query patterns
- •Scripting - JSON parsing, automation, and integration patterns
- •Best Practices - How to Linear: workflows, hygiene, triage, and anti-patterns