A lightweight CLI wrapper for Linear's GraphQL API designed for deterministic automation and agentic integration.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install linear-cli
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 linear-cli 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 CLI?
The Linear CLI skill provides a streamlined interface for interacting with Linear using Api2Cli (a2c) and declarative GraphQL request configurations. It is specifically designed to work within the ecosystem of Openclaw Skills, offering a deterministic way to handle project management tasks without the overhead of custom HTTP client code. By leveraging a wrapper script that generates its workspace config at runtime, it ensures high reliability for developers and automated agents.
This skill simplifies complex API interactions into predictable commands, making it easier to integrate Linear's powerful features into larger automated workflows. Whether you are managing issues or querying workspace state, this tool provides the necessary bridge between your local environment and the Linear platform.
Linear CLI Use Cases
- Automating project management updates within a development pipeline.
- Integrating Linear task tracking into AI agent logic within Openclaw Skills.
- Fetching workspace and user metadata directly from the command line.
- Standardizing GraphQL requests across different team environments.
How Linear CLI Works
- The user exports their Linear API key to the environment as LINEAR_API_KEY.
- The system verifies that the a2c (Api2Cli) dependency is available on the system PATH.
- The wrapper script dynamically generates a workspace configuration based on predefined GraphQL queries and mutations.
- Commands are mapped to specific GraphQL definitions located in the config.xfer file.
- The tool executes the request and returns structured data to the user or calling agent for processing.
Linear CLI Setup
First, ensure that a2c is installed and accessible in your environment. Then, configure your credentials and test the connection using the provided wrapper script.
# Export your Linear API Key
export LINEAR_API_KEY="<your_linear_api_key>"
# Run the help command to see available actions
./scripts/linear --help
# Perform a smoke test to verify authentication
./scripts/linear whoami
Linear CLI Data Schema & Taxonomy
The skill organizes its operations through a declarative structure that maps CLI inputs to GraphQL outputs via Api2Cli.
| File/Variable | Type | Purpose |
|---|---|---|
scripts/linear |
Shell Wrapper | The primary entrypoint for executing commands. |
a2c/config.xfer |
Config File | Contains the GraphQL request definitions and mappings. |
LINEAR_API_KEY |
Env Variable | Secret token required for Linear GraphQL API authentication. |
Linear CLI Advanced Features
- Zero-code HTTP client implementation using declarative GraphQL definitions via a2c.
- Automated workspace configuration generation at runtime to support ephemeral environments.
- Deterministic CLI surface designed for seamless integration with Openclaw Skills agents.
- High-performance execution with minimal dependency footprint on the host system.
SKILL.md
Loading
Related Openclaw Skills
Kanban Workflow
A TypeScript-based project management skill that enables AI agents to manage tasks across multiple platforms using a standardized stage-based workflow.
Kanban Workflow
A TypeScript-based agentic skill that synchronizes project management platforms using a canonical stage-based workflow.
EODHD API Financial Data Skill
A powerful financial data toolkit that connects Openclaw Skills agents to the EODHD API for comprehensive market analysis and data retrieval.
PostHog API Skill
A comprehensive integration for managing PostHog analytics, feature flags, and HogQL queries via the REST API.
Plane CLI Integration
A lightweight Openclaw skill wrapping the Plane API via Api2Cli to manage workspaces, projects, and work items from the command line.
Ape Claw
Ape Claw enables AI agents to bridge assets and execute NFT transactions on ApeChain with strict policy gating and real-time telemetry.
Featured*
