🚀 Linear CLI (Community Project)

✨ Features

• 📋 View Issues - Browse your issues, team issues, or all issues
• 🔍 Search - Find issues quickly with real-time search
• ➕ Create Issues - Create new issues directly from terminal
• 🔗 GitHub Integration - View linked PRs and open them instantly
• ⚡ Fast & Responsive - Built with Bun for ultra-fast performance
• 💾 Smart Caching - Instant navigation with intelligent cache

🚧 Roadmap

• [ ] Edit existing issues
• [ ] Add/view comments
• [ ] Bulk operations (close, assign, label)
• [ ] Project and milestone filtering
• [ ] Custom views and saved filters
• [ ] Time tracking integration
• [ ] Slack notifications
• [ ] Export to CSV/JSON
• [ ] Offline mode with sync
• [ ] Team performance analytics

🚀 Quick Start

Requirements

• Bun >= 1.0.0
• Linear API token (How to get)

Installation

Install from npm

# Install globally with npm
npm install -g @asazutaiga/linear-cli

# Or with bun
bun install -g @asazutaiga/linear-cli

Build from source

# Clone repository
git clone https://github.com/asazutaiga/linear-cli.git
cd linear-cli

# Install dependencies
bun install

# Build & global install
bun run link-local

Initial Setup

# Set API token
linear config set-token <your-token>

# Set default team (optional)
linear config set-team

📖 Usage

Basic Commands

# Interactive menu
linear

# View my current cycle issues
linear mine

# View all my issues
linear mine-all

# View team's current cycle issues
linear cycle

# Search issues
linear search

# Create new issue
linear create

Keyboard Shortcuts

Navigation

• ↑/↓ or j/k - Navigate lists
• Enter - Select/Open
• q or Esc - Go back/Exit

Issue Details

• 1-9 - Open numbered links
• c - Copy issue info to clipboard
• j/k - Scroll content

🛠️ Development

# Development mode
bun run dev

# Run tests
bun run test

# Type checking & linting
bun run check

# Build for production
bun run build

Project Structure

src/
├── cli.tsx              # CLI entry point
├── components/          # React Ink UI components
├── services/           # Business logic & API
└── utils/              # Utilities & helpers

🔧 Configuration

Configuration is stored in ~/.config/configstore/linear-cli.json

• linearApiToken - Your Linear API token
• defaultTeamId - Default team for operations
• defaultProjectId - Default project (optional)

🤝 Contributing

Pull requests are welcome! For major changes, please open an issue first.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📝 License

MIT License - See LICENSE file for details.

📌 Disclaimer

This is an unofficial community project and is not affiliated with, endorsed by, or supported by Linear. Linear is a trademark of Linear Orbit, Inc.

🙏 Acknowledgments

• Linear - Project management platform
• Ink - React for CLIs
• Bun - JavaScript runtime & toolkit