linear-tui

Linear in your terminal, with Linear's shortcuts, and context for your coding agent.

Why use linear-tui

• It works like Linear. The sidebar, Favorites, saved views, grouped and collapsible lists, the issue page with rendered Markdown and threaded comments, plus Linear's keys: c to create, s / p / a / i to update, g then a letter to go places.
• Network work stays off the UI thread. Requests run in the background, and changes appear as you make them, so moving around stays responsive on a slow connection.
• It shares terminal context with your coding agent. linear-tui context tells an agent which issue you have open and which row your cursor is on; notes you jot while reading go to it as one prompt.
• It is a single binary. No application to register, no client secret, no OpenSSL: linear-tui auth login and you are in.

Highlights

Command palette

The command palette lists the available actions for where you are, with each shortcut, and finds any issue, project, cycle, view, or team page by name or ID.

Reopens where you left off

Each repository, including each worktree of it, reopens on the page, list settings, and issue you last had open there. Pages are remembered by Linear ID, so a reordered sidebar does not reopen the wrong one.

Agent context

linear-tui context                       # the page, the open issue, the list with your cursor
linear-tui issue show ENG-42             # description, fields, and comments as Markdown
linear-tui issue comment ENG-42 -        # comment, body from stdin
linear-tui issue status ENG-42 "In Review"

Say "fix this one" or "look at the top three" and the agent knows which you mean. With the agent plugin, Claude Code and Codex learn these commands on their own, without a prompt being sent. While you read, n notes an issue and Ctrl+S sends your notes to the agent as one prompt. More on agents

herdr integration

In herdr, linear-tui opens in a pane beside your agents: notes go to the agent next to it, issue rows show which agent is working on them, g w jumps to that agent, and Ctrl+clicking a Linear link opens it in linear-tui. The herdr plugin

Additional features

Favorites and saved views as Linear evaluates them · sub-issues nested under their parent · Active / Backlog / All presets · mouse support · CJK-aware layout and Markdown line breaking · copy the ID, URL, or branch name over SSH · dark, light, and ocean themes.

Install

cargo install linear-tui

Pre-built binaries for Linux, macOS (Intel and Apple Silicon), and Windows are on the Releases page. To build from a checkout, cargo install --path . needs only a Rust toolchain.

Get started

linear-tui

The first run asks how to connect: through the browser, or with a personal API key, and opens your issues. Signing in covers SSH, admin-approved workspaces, and your own OAuth application.

A few keys to begin with:

Documentation

The full index is docs/README.md.

License

MIT