Linear for Openclaw

A powerful command-line interface for Linear that integrates issue tracking and project management directly into your development workflow.

cipher-shad0w
v1.0.1
Feb 10, 2026
0
1.7k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install openclaw-linear

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install openclaw-linear using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Linear?

The Linear skill for Openclaw Skills provides a comprehensive command-line interface to interact with your Linear workspace efficiently. It allows developers to handle the entire lifecycle of an issue—from creation and assignment to progress tracking and completion—without ever leaving the terminal. By bridging the gap between project management and the local coding environment, this skill significantly enhances developer velocity.

Built to handle complex workflows, it offers deep integration with version control systems like git and jj. Whether you are managing team milestones, updating project statuses, or querying the Linear GraphQL API for custom data, this Openclaw Skills integration ensures your project management stays as fast as your code.

Linear Use Cases

  • Creating and updating issues instantly during active development sessions.
  • Automating project status updates and milestone tracking from the CLI.
  • Synchronizing local git branches with Linear issue identifiers automatically.
  • Querying the Linear GraphQL API for custom data exports or advanced automation.
  • Managing team documentation and project specifications directly from local markdown files.

How Linear Works

  1. Authenticate with your Linear workspace using a generated API key or the interactive login command.
  2. Configure project-specific settings via environment variables or a .linear.toml file to set your default team and workspace.
  3. Execute high-level CLI commands to fetch, create, or modify issues, projects, and labels.
  4. Utilize the built-in VCS integration to automatically create and switch to branches linked to specific issue IDs.
  5. Access the raw GraphQL API fallback for complex queries and filters that require direct database interaction.

Linear Setup

Ensure the linear command is available on your PATH. You can install it via various methods:

# Install via Homebrew
brew install schpet/tap/linear

# Install via Deno
deno install -A --reload -f -g -n linear jsr:@schpet/linear-cli

After installation, follow these steps to configure Openclaw Skills for your workspace:

  1. Create an API key at https://linear.app/settings/account/security.
  2. Run linear auth login to authenticate your session.
  3. Navigate to your project repository and run linear config to generate your local configuration.

Linear Data Schema & Taxonomy

The skill manages data through a combination of local configuration files and remote API objects. Below is how the data is organized:

Component Source Purpose
.linear.toml Local File Stores Team ID, Workspace slug, and VCS preferences (git/jj).
GraphQL Schema Remote API Defines the structure for Issues, Projects, Teams, and Documents.
Environment Vars Shell Env Overrides configuration for Team IDs and Issue sorting (LINEAR_TEAM_ID, etc).
Metadata Openclaw Tracks installation requirements and OS compatibility (Darwin, Linux, Win32).

Linear Advanced Features

  • Deep Git and Jujutsu (jj) integration for automated branch management linked to issues.
  • Raw GraphQL API access with support for variables and JSON-based filtering for power users.
  • Interactive issue creation and 'start' workflows that automate the transition from task to code.
  • Document management system that allows creating Linear docs directly from local markdown files.
  • Multi-level configuration support allowing for global, repository, and directory-specific settings.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins linear
Github Stars: 0
forks: 0

Featured*