A command-line interface for [Linear](https://linear.app) built with Bun and Effect TypeScript.
npm install @cvr/linearA command-line interface for Linear built with Bun and Effect TypeScript.
``bashClone and build
git clone
cd linear
bun install
bun run build
Usage
`bash
Authenticate (required first)
linear authCheck current user
linear auth whoamiList your issues
linear issue listStart working on an issue
linear issue start ABC-123View issue details
linear issue view ABC-123Create a new issue
linear issue createList teams
linear team list
`Commands
$3
| Command | Description |
| -------------------- | ---------------------------------------------------- |
|
linear auth | Authenticate with Linear (opens browser for API key) |
| linear auth whoami | Show current user info |$3
| Command | Description |
| ------------------------- | ------------------------------------------------ |
|
linear issue list | List your assigned issues |
| linear issue view [id] | View issue details (interactive picker if no ID) |
| linear issue start [id] | Start working on an issue |
| linear issue create | Create a new issue |$3
| Command | Description |
| ------------------ | -------------- |
|
linear team list | List all teams |Configuration
- Token:
~/.config/linear/token
- Global config: ~/.config/linear/config.toml
- Project config: .linear.toml in repo root$3
Create a
.linear.toml in your project root to set defaults:`toml
team_id = "ENG"
`$3
-
LINEAR_API_KEY: Alternative to config file tokenDevelopment
`bash
Install dependencies
bun installRun tests
bun run testBuild binary
bun run buildRun without building
bun run src/main.ts --help
``Built with:
- Bun: Fast JavaScript runtime with native compilation
- Effect: TypeScript library for type-safe, composable code
- @effect/cli: CLI framework with prompts and argument parsing
- @linear/sdk: Official Linear GraphQL SDK
Inspired by schpet/linear-cli - the original Linear CLI built with Deno and Cliffy.
MIT