Linear for Openclaw

A command-line integration for Linear that allows AI agents to manage issues, teams, and project states seamlessly.

emrekilinc
v1.0.0
Jan 27, 2026
0
3.6k
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install linear-issues

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 linear-issues 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 powerful interface for interacting with the Linear issue tracking platform directly from your development environment. It empowers developers and AI agents to create, update, and search for issues without context switching. By leveraging Openclaw Skills, teams can ensure their project management remains synchronized with their codebase in real-time.

This integration is designed to streamline the lifecycle of a task, from initial bug reporting to final resolution. Whether you are managing personal tasks or coordinating across a large organization, this skill provides the programmatic access needed to maintain high velocity within the Openclaw Skills ecosystem.

Linear Use Cases

  • Automating the creation of bug reports when an AI agent identifies code defects.
  • Moving issues to In Progress or Done status automatically based on git activity.
  • Searching for existing tasks to provide context to an AI agent before starting a new feature.
  • Adding automated comments to issues to document progress or reference specific pull requests within Openclaw Skills workflows.

How Linear Works

  1. The skill authenticates with the Linear API using a secure key stored in the local credentials directory.
  2. Users or agents interact with the scripts/linear.sh script to trigger specific project management actions.
  3. The script fetches metadata such as Team IDs, State IDs, and User IDs to ensure precise targeting of commands.
  4. Commands are processed and sent to Linear, with results returned either as human-readable text or raw JSON for further processing by Openclaw Skills.

Linear Setup

To get started with this skill, you must store your API key in the designated credentials file:

mkdir -p ~/.clawdbot/credentials
echo '{"apiKey": "your_api_key_here"}' > ~/.clawdbot/credentials/linear.json

Ensure that scripts/linear.sh is executable and accessible within your Openclaw Skills environment.

Linear Data Schema & Taxonomy

The skill manages interaction data through a combination of local configuration and remote API responses. The primary data structures used by this Openclaw Skills integration include:

Component Format Description
Credentials JSON Stores the apiKey in ~/.clawdbot/credentials/linear.json
Command Output String/JSON Standard output for CLI use or raw JSON when using the --json flag
Issue Metadata Object Includes Title, Description, State, Priority, and Assignee details

Linear Advanced Features

  • Support for raw JSON output via the --json flag for advanced scripting and multi-agent coordination.
  • Comprehensive workspace search to find relevant issues across all teams and projects.
  • Granular state management allowing for precise control over custom workflow transitions.
  • Deep integration with Openclaw Skills allowing agents to query team-specific metadata like user lists and workflow states.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*