linear-tui

A TUI client for Linear.app — manage issues, projects, and cycles from your terminal.

Built with ratatui and the Linear GraphQL API.

Features

• Issue management — Browse, search, filter, and mutate issues (status, priority, assignee, comments)
• Multiple views — Issues, My Issues, Projects, Cycles with tab-based navigation
• Project & Cycle detail — Drill into projects/cycles to see their issues
• Vim-style keybindings — j/k navigation, / search, ? help
• OAuth2 + PKCE authentication — Secure login via browser, or use a personal API key
• Theme support — Default (dark), Light, and Ocean color schemes
• Pagination — Cursor-based infinite scrolling for large issue lists

Installation

From crates.io

cargo install linear-tui

From GitHub Releases

Pre-built binaries are available for Linux, macOS (Intel/Apple Silicon), and Windows on the Releases page.

From source

git clone https://github.com/k1-c/linear-tui.git
cd linear-tui
cargo install --path .

Getting Started

1. Authenticate

OAuth2 (recommended)

linear-tui auth login

Opens your browser for Linear OAuth authorization. Tokens are stored locally and refreshed automatically.

Personal API Key

Generate a key at Linear Settings > API, then:

linear-tui auth token <your-api-key>

2. Launch

linear-tui

Keybindings

Configuration

Config file: ~/.config/linear-tui/config.toml

[auth]
# OAuth tokens are managed automatically via `linear-tui auth login`
# To use a personal API key instead:
# api_key = "lin_api_xxxxx"

[ui]
default_team = "Core"       # Auto-select this team on startup
items_per_page = 50          # Issues per page (pagination)
theme = "default"            # "default" | "light" | "ocean"

Themes

License

MIT