skills.rest
mmnavarr
mmnavarrCOMMUNITY
Explore all skills by this author →
Website𝕏@mxlcolmGitHub

linear-cli

Manage Linear issues, projects, and teams from the command line.

Updated May 11, 2026
Search Tags:#automation#project management#cli#graphql#issue tracking#git integration#linear
One-click install
npx skills add https://github.com/mmnavarr/harness --skill linear-cli-mmnavarr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: linear-cli
Source: https://github.com/mmnavarr/harness/tree/main/skills/linear-cli
Command: npx skills add https://github.com/mmnavarr/harness --skill linear-cli-mmnavarr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @std/path, and includes scripts (resource) and references (resource) components.

What problem does it solve? Managing Linear issues, projects, and teams through the web UI interrupts terminal-based development workflows. This Skill lets you create, update, list, and organize Linear resources directly from the command line, with git and jj integration for branch-based issue tracking. ## Core Features & Use Cases - Full Issue Lifecycle: Create, update, list, comment on, and delete issues, including bulk operations and file-based markdown descriptions for proper formatting. - Organization Management: Manage teams, projects, cycles, milestones, initiatives, labels, and documents, plus project and initiative status updates. - Git Integration: Detect issues from the current branch, start work with automatic branch creation, and create GitHub pull requests linked to issues. - Use Case: While working on a feature branch, run linear issue start to check out the issue, then create a pull request with linear issue pull-request that automatically includes the Linear issue details. ## Quick Start Ask the AI to list your unstarted Linear issues for your team using the linear CLI, then create a new issue with a markdown description file.

Frequently Asked Questions about linear-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Linear issue from the command line?▼

Use linear issue create with a --title flag and optionally --team, --assignee, --priority, and --label. For markdown descriptions, write the content to a file and pass it with --description-file to preserve formatting.

How do I add markdown descriptions to Linear issues via CLI?▼

Write the markdown to a temporary file and pass it with --description-file for issues or --body-file for comments. This avoids shell escaping problems and prevents literal newline sequences from appearing in the Linear web UI.

Can I use the linear CLI without installing it globally?▼

Yes, prefix any command with npx @schpet/linear-cli instead of linear. All subcommands work identically through npx without a global installation.

Why does linear issue list fail with a sort order error?▼

The issue list command requires a sort order via --sort (manual or priority), the issue_sort config option, or the LINEAR_ISSUE_SORT environment variable. It also needs --team unless the team can be inferred from the current directory.

How do I run GraphQL queries against the Linear API?▼

Use linear api with an inline query for simple cases, or heredoc stdin for queries containing non-null type markers. Pass variables with --variable or --variables-json, and inspect available fields with linear schema.

Does the linear CLI support bulk issue deletion?▼

Yes, linear issue delete accepts --bulk with multiple identifiers, --bulk-file to read IDs from a file, or --bulk-stdin to read them from standard input. Similar bulk flags exist for initiatives and documents.

Related Skills

Explore More Software Engineering Skills→
holon-runholon-run
111

linear-graphql-skill

Manage Linear issues, projects, and teams via GraphQL API.

Official
Intermediate
arch-teamarch-team
73

pace-sync

Synchronize devpace development state with GitHub, Linear, and Jira.

Community
Advanced
pegasus-isipegasus-isi

commit

Generate Conventional Commits from git status, diffs, and branch metadata.

Official
Intermediate
schpetschpet
897

linear-cli

Manage Linear issues via a command-line interface and GraphQL API.

Community
Advanced