Linear CLI

A command-line interface to interact with Linear App.

Installation

sudo npm install -g @digitalstories/linear-cli

Configuration

Before using the tool, you need to configure your Linear API token:

linear config set-token <your-api-token>

To get your API token, visit Linear API Settings.

Available Commands

Configuration

• linear config set-token <token>: Configure your Linear API token
• linear config set-language: Select interface language
• linear config get-language: Show current language

The CLI supports both English and French languages. The default language is English, but you can change it using the config set-language command.

Team Management

• linear teams list: List all available teams
• linear teams select: Select a team interactively
• linear teams current: Show currently selected team
• linear teams clear: Clear active team selection

Project Management

• linear projects list: List all available projects
• linear projects create: Create a new project
  • -n, --name <name>: Project name (required)
  • -d, --description <description>: Project description
  • -i, --icon <emoji>: Emoji to use as icon
  • -c, --color <color>: Color in hexadecimal format (e.g., #FF0000)
  • -s, --select: Automatically select the project after creation
• linear projects select: Select a project interactively
• linear projects current: Show currently selected project
• linear projects clear: Clear active project selection

Issue Management

• linear issues list: List issues (filtered by project if one is selected)
• linear issues create: Create a new issue
• linear issues update <id>: Update an existing issue
• linear issues comment add <id> -m <message>: Add a comment to an issue
• linear issues comment list <id>: List all comments for an issue

Note: When a project is selected, all issue management commands apply only to that project. If no project is selected, commands apply to all projects.

Development

# Install dependencies
npm install

# Compile TypeScript and copy i18n files
npm run build

# Run in development mode
npm run dev

Internationalisation

Le CLI supporte l'internationalisation via des fichiers JSON dans le dossier src/i18n/locales/. La structure des fichiers est la suivante :

src/
├── i18n/
│   ├── index.ts
│   └── locales/
│       ├── en.json
│       └── fr.json

Pour ajouter une nouvelle traduction :

1. Créez un nouveau fichier JSON dans le dossier locales/
2. Ajoutez vos traductions en suivant la même structure que les fichiers existants
3. La langue sera automatiquement disponible via la commande config set-language

License

MIT