linear-tui

Linear in your terminal — with Linear's own shortcuts, and a coding agent that sees what you see.

Why linear-tui

• It feels like Linear. The sidebar, Favorites, saved views, grouped and collapsible lists, the issue page with rendered Markdown and threaded comments — and Linear's keys: c to create, s / p / a / i to update, g then a letter to go places.
• It never waits on the network. Every request runs off the UI thread, and every change shows at once, so moving around stays instant on a slow connection.
• It shares your screen 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 one binary. No application to register, no client secret, no OpenSSL: linear-tui auth login and you are in.

Highlights

Everything behind Ctrl+K

The command palette lists every action for where you are, with its shortcut, and finds any issue, project, cycle, view, or team page by name or ID.

Picks up where you left off

Each repository — and every 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 never reopens the wrong one.

Your agent sees what you see

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 →

At home in herdr

In herdr, linear-tui opens in a pane beside your agents: notes go straight 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 →

And the rest

Favorites and saved views exactly 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