A specialized CLI for Linear.app that provides structured JSON output optimized for LLM agents and automation.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install linearis
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install linearis 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 linearis?
linearis is a powerful command-line utility designed to bridge the gap between your project management in Linear.app and your automated workflows. Built with a focus on machine readability, it serves as an essential component for Openclaw Skills that require programmatic access to issues, comments, and documentation. By transforming Linear's interface into a JSON-first CLI, it enables developers and AI agents to execute complex project tasks with precision.
Whether you are updating ticket statuses, searching through cycles, or managing project documents, this tool ensures that the data is delivered in a format ready for immediate processing. It is particularly valuable for developers building sophisticated autonomous agents that need to act as members of a product team within the Openclaw Skills framework.
linearis Use Cases
- Orchestrating automated sprint updates and issue transitions using AI agents.
- Searching and retrieving technical specifications from Linear documents via CLI.
- Bulk updating issue priorities and labels across multiple teams.
- Integrating project management tasks into CI/CD pipelines through Openclaw Skills.
How linearis Works
- Install the package globally using npm and configure your Linear personal API token for secure access.
- Utilize specific subcommands for issues, documents, or teams to interact with the Linear API.
- The tool fetches requested data and outputs it as raw JSON, making it compatible with Openclaw Skills logic.
- Process the output using standard Unix tools or feed it directly into LLM prompts for intelligent task execution.
linearis Setup
To get started, install the tool via npm:
npm install -g linearis
Authentication can be handled by saving your token to a local file:
echo "your_api_token" > ~/.linear_api_token
Alternatively, set the LINEAR_API_TOKEN environment variable or use the --api-token flag during command execution.
linearis Data Schema & Taxonomy
The tool organizes data into logical entities corresponding to the Linear API structure. Most responses return arrays or objects of JSON data.
- Issues: Includes fields for identifier, title, status, priority (0-4), and assignee.
- Documents: Contains title and Markdown content for project specs.
- Metadata: Returns lists of active teams, users, projects, and cycles for workspace context.
- Assets: Manages file URLs for uploads and local paths for downloads.
linearis Advanced Features
- JSON-first output architecture for direct compatibility with Openclaw Skills and automation scripts.
- Support for complex issue updates, including parent-child ticket relationships and label management.
- Command-line file upload and download capabilities for managing ticket attachments.
- Detailed usage reference accessible via the linearis usage command for rapid developer onboarding.
SKILL.md
Loading
Related Openclaw Skills
YouTube Music Player Automation
A browser-based automation skill that enables AI agents to search, play, and manage YouTube music sessions using playwright-cli.
Exa Web Search (Free)
A neural search skill providing web, code, and company research capabilities without requiring an API key.
RedBookSkills
An automated workflow for publishing, managing, and analyzing image-text and video content on Xiaohongshu via browser automation.
Doge OSS Upload
A professional utility to upload local files to DogeCloud OSS and retrieve structured metadata with public access URLs.
YouTube Summarizer
An automated tool to extract metadata, transcripts, and external research to create comprehensive, structured summaries of YouTube videos.
QR Code Generator
A lightweight utility for transforming text or URLs into QR code images via a pre-configured Python script.
Featured*
