Linear Todo Sync

The Linear Todo Sync skill is a powerful automation tool designed for software engineers and project managers who utilize Linear for issue tracking. By leveraging the Linear GraphQL API, this skill programmatically retrieves all open tasks currently assigned to the authenticated user. It automatically processes the API response to generate a structured, human-readable markdown todo list directly in the project root. This tool is ideal for users who want to maintain focus, track their workload, and ensure their local development environment is synced with their team's project management platform.

• Automatically queries the Linear GraphQL API to fetch assigned issues excluding completed or canceled states.

• Organizes work items by project, displaying essential metadata including status, priority, labels, estimates, and due dates.

• Generates a timestamped markdown file, such as linear-todos-YYYY-MM-DD.md, allowing for historical progress tracking.

• Enhances developer productivity by providing a clear, actionable summary of what needs to be worked on immediately.

• Requires Python 3.7+ and standard libraries: requests, mdutils, and python-dotenv.

• Setup requires a valid Personal API Key from Linear configured within a local .env file using the LINEAR_API_KEY environment variable.

• Best triggered via natural language prompts like 'Show me my work', 'Sync my Linear tasks', or 'What do I need to work on?'.

• Users can customize the GraphQL query within the provided script to include additional fields or filter tasks by custom criteria.

• Ensure the .env file is included in your .gitignore to protect sensitive API credentials.

• The output markdown includes direct URL links to Linear issues for quick navigation back to the source platform for deeper detail or state updates.