Official Verified

linear-todos

A CLI tool that executes Python source code to manage todos via Linear's API. Creates tasks with natural language dates, priorities, and scheduling. This is a source-execution skill - code in src/linear_todos/ runs when commands are invoked.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/avegancafe/linear-todos

Download Source Code (.zip)

Linear Todos

⚠️ This is a SOURCE-EXECUTION skill. The agent runs Python code from src/linear_todos/ when you invoke CLI commands. This is not instruction-only. Review src/linear_todos/api.py before first use.

🔐 Security Note: This skill stores your Linear API key in plaintext JSON at ~/.config/linear-todos/config.json only if you run the setup command. Use a dedicated API key with minimal scope. The key is only used for Linear API calls and is never transmitted elsewhere. Prefer environment variables (LINEAR_API_KEY) to avoid persisted state.

Audit Info: This skill makes HTTPS requests only to api.linear.app (Linear's official GraphQL API). No data is sent elsewhere. See src/linear_todos/api.py for the API client implementation.

Credentials

Variable	Required	Description
`LINEAR_API_KEY`	Yes	Your Linear API key from linear.app/settings/api
`LINEAR_TEAM_ID`	No	Default team ID for todos
`LINEAR_STATE_ID`	No	Default state for new todos
`LINEAR_DONE_STATE_ID`	No	State for completed todos
`LINEAR_TIMEZONE`	No	Your local timezone (e.g., `America/New_York`, `Europe/London`). Used for "end of day" calculations. Falls back to OpenClaw `USER.md` timezone if available.

Config Path: ~/.config/linear-todos/config.json (created by setup, permissions 0o600)

Security & Auditing

What This Skill Does

HTTP Requests: Makes HTTPS requests only to https://api.linear.app/graphql (Linear's official API). No telemetry, no third-party services.
Data Storage: Stores your API key and config in ~/.config/linear-todos/config.json (plaintext, permissions 0o600) only if you run the setup command. Team/issue data is fetched fresh each run — nothing is cached locally except your config.
Runtime Behavior: This skill runs from bundled Python source code (not preinstalled system tools). The agent executes main.py and code in src/linear_todos/ when you run CLI commands.
Setup Behavior: During interactive setup, the wizard temporarily sets LINEAR_API_KEY in the process environment to test the key. This is only during the setup session and is not persisted.
No Auto-Enable: Does not request platform privileges (always: false). Will not auto-enable itself for all agents.
Code Locations:
- src/linear_todos/api.py — All HTTP requests to Linear
- src/linear_todos/config.py — Config file handling
- src/linear_todos/setup_wizard.py — Interactive setup
- src/linear_todos/cli.py — CLI commands

Recommended Security Practices

Read Full Documentation on GitHub

Metadata

Author@avegancafe

Stars2387

Updated2026-03-09

View Author Profile

AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill

Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-avegancafe-linear-todos": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Related Skills

solopreneur-assistant

AI Chief of Staff for solo businesses — inbox triage, task prioritization, revenue tracking, decision journals, opportunity scoring, and weekly reviews.

clawdssen 2387

Meeting Brief Copilot

Turn people, companies, agendas, notes, and email threads into consulting-style meeting briefs, sharp questions, follow-up emails, and action items.

atwatcher 2387

farmos-tasks

Query and manage farm work orders and tasks. View assignments, create tasks, update status. Uses integration endpoints (no auth) for reads and authenticated endpoints for writes.

brianppetty 2387

daily-report-generator

Automatically generate daily/weekly work reports from git commits, calendar events, and task lists. Use when you need to quickly create professional work reports without manual effort.

1989tianlong 2387

gamification

XP system for productivity gamification via ClawdBot - track levels, badges, streaks, and achievements

chipagosfinest 2387