# linear-cli — Issue Management CLI (Git/JJ Aware)

> linear-cli manages Linear issues from the terminal (list/start/create) and even ships an agent skill; verified 701★ and pushed 2026-05-14.

## Install

Copy the content below into your project:

## Quick Use

```bash
brew install schpet/tap/linear
linear config
linear issue mine
linear issue start
```

## Intro

linear-cli manages Linear issues from the terminal (list/start/create) and even ships an agent skill; verified 701★ and pushed 2026-05-14.

**Best for:** Developers who live in the terminal and want issue/branch workflows that stay synced with Linear

**Works with:** Homebrew or Node (npm/pnpm/bun) plus a Linear workspace/account

**Setup time:** 5-12 minutes

### Key facts (verified)

- GitHub: 701 stars · 75 forks · pushed 2026-05-14.
- License: ISC · owner avatar + repo URL verified via GitHub API.
- README-backed entrypoint: `linear issue list`.

## Main

- End-to-end issue flow: README shows listing, searching, starting issues (creating branches), and generating PRs via gh CLI integration.

- Repo-aware views: README says it is git and jj aware to keep you in the right Linear views for your current branch/context.

- Agent-friendly: README explicitly notes it includes a skill so agents can create issues and update status alongside code changes.

- Multiple install options: README includes Homebrew plus npm/pnpm/bun and a deno(jsr) path.

### Source-backed notes

- README lists example commands like `linear issue mine`, `linear issue query`, `linear issue start`, and `linear issue create`.
- README includes install paths: `brew install schpet/tap/linear` and `npm install -D @schpet/linear-cli` (plus pnpm/bun).
- README states it works well with AI agents and ships a skill section for agent usage.

### FAQ

- **Do I need the Linear UI?**: Not for day-to-day actions — README positions the CLI as a complement to web/desktop apps.
- **Does it create branches automatically?**: README shows `linear issue start` which can create a branch for the chosen issue.
- **How do agents use it?**: Use the skill section in README; the CLI exposes issue actions that agents can call as steps in automation.

## Source & Thanks

> Source: https://github.com/schpet/linear-cli
> License: ISC
> GitHub stars: 701 · forks: 75

---

<!-- ZH -->

## Quick Use

```bash
brew install schpet/tap/linear
linear config
linear issue mine
linear issue start
```

## Intro

linear-cli 让你在终端管理 Linear issue（列出/开始/创建），并提供 agent skill 与 PR 相关能力，便于自动化协作；已验证 701★，最近更新 2026-05-14。

**Best for:** 重度终端用户，希望 issue/分支工作流与 Linear 保持同步的开发者

**Works with:** Homebrew 或 Node（npm/pnpm/bun），以及 Linear 工作区账号

**Setup time:** 5-12 minutes

### Key facts (verified)

- GitHub：701 stars · 75 forks；最近更新 2026-05-14。
- 许可证：ISC；作者头像与仓库链接均已通过 GitHub API 复核。
- README 中可对照的入口命令：`linear issue list`。

## Main

- 覆盖完整 issue 流：README 展示 list/search/start（自动建分支）以及结合 gh CLI 生成 PR 的路径。

- 仓库上下文适配：README 表示支持 git 与 jj，尽量把你带到与当前分支对应的 Linear 视图。

- 对 agent 友好：README 明确提到提供 skill，让 agent 能创建 issue、更新状态并贴合代码改动。

- 安装方式丰富：README 包含 Homebrew、npm/pnpm/bun，以及 deno(jsr) 的安装方式。

### Source-backed notes

- README 列出示例命令：`linear issue mine`、`linear issue query`、`linear issue start`、`linear issue create` 等。
- README 给出安装方式：`brew install schpet/tap/linear` 与 `npm install -D @schpet/linear-cli`（也含 pnpm/bun）。
- README 说明它“works great with AI agents”，并提供 skills 章节用于 agent 接入。

### FAQ

- **还需要 Linear UI 吗？**：多数日常操作不需要。README 把它定位为 web/desktop 的补充，让你尽量留在终端。
- **会自动创建分支吗？**：README 展示 `linear issue start` 可以在选择 issue 后创建分支。
- **agent 怎么用？**：参考 README 的 skills 章节；CLI 把 issue 操作变成可编排的动作。

## Source & Thanks

> Source: https://github.com/schpet/linear-cli
> License: ISC
> GitHub stars: 701 · forks: 75


---
Source: https://tokrepo.com/en/workflows/linear-cli-issue-management-cli-git-jj-aware
Author: Script Depot