Linear Todos for Openclaw

A sophisticated CLI tool for managing Linear tasks through natural language commands and automated priority scheduling.

avegancafe
v1.1.0
Feb 19, 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 linear-todos

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-todos 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 Todos?

Linear Todos is a high-performance source-execution skill that allows developers to interact with the Linear API directly from their terminal. It streamlines task management by converting simple natural language inputs into structured Linear issues, complete with specific deadlines and priority levels. This skill serves as a vital bridge for developers using Openclaw Skills who need to maintain their workflow focus while staying on top of project requirements.

By executing local Python source code, this tool ensures that your task management is both fast and secure. It offers a comprehensive suite of commands for creating, listing, and reviewing todos, making it an essential utility for anyone looking to integrate their project management into a terminal-based environment.

Linear Todos Use Cases

  • Rapidly create tasks and reminders during active coding sessions without switching windows.
  • Schedule complex deadlines using natural language phrases like next Monday or in 3 days.
  • Perform structured daily reviews of overdue and high-priority tasks to maintain momentum.
  • Automate status updates and task completions through direct CLI interaction.

How Linear Todos Works

  1. The user initiates a command via the Python CLI, which activates the local source code located in the skill directory.
  2. The utility parses the input arguments, translating natural language dates into ISO-standard timestamps and mapping priorities to Linear's internal schema.
  3. The skill authenticates using a secure API key and transmits a GraphQL request to Linear's official API endpoints.
  4. Real-time data is retrieved and formatted into a human-readable summary or a structured JSON output for the user.

Linear Todos Setup

To begin using this skill with Openclaw Skills, follow these installation steps:

# Navigate to the skill directory and run the interactive setup
uv run python main.py setup

# Or configure via environment variables for a stateless setup
export LINEAR_API_KEY="your_api_key_here"
export LINEAR_TEAM_ID="your_team_id"

The setup wizard will verify your credentials and help you select your default team and task states.

Linear Todos Data Schema & Taxonomy

This skill manages a mix of local configuration and cloud-based task data. Metadata and credentials are handled with strict security protocols.

Data Component Location Format
Configuration ~/.config/linear-todos/config.json Plaintext JSON (Permissions 0o600)
Credentials Environment or Config API Token
Task Data Linear GraphQL API Remote Retrieval (No local cache)
Timezone Settings Config or USER.md IANA Timezone String

Linear Todos Advanced Features

  • Advanced natural language date parsing for intuitive scheduling and reminders.
  • Intelligent timezone support that automatically synchronizes with Openclaw Skills workspace settings.
  • Automated daily review mode that categorizes tasks by urgency and overdue status.
  • Pre-configured cron job examples for setting up automated morning digests and task reminders.
  • Support for custom priority levels ranging from Urgent to Low for granular control.

SKILL.md


Loading

Related Openclaw Skills

Featured*