Linear Todo Sync

3. Configure Environment

Create a .env file in your project root:

cp .claude/skills/linear-todo-sync/assets/.env.example .env

Edit .env and add your API key:

LINEAR_API_KEY=lin_api_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Important: Ensure .env is in your .gitignore to protect your API key.

4. Verify Setup

Test the configuration by running:

python .claude/skills/linear-todo-sync/scripts/sync_linear_tasks.py

A markdown file named linear-todos-YYYY-MM-DD.md should appear in your project root.

How It Works

When triggered, this skill:

1. Loads credentials from the .env file in your project root
2. Queries Linear API using GraphQL to fetch all assigned issues in non-completed states
3. Retrieves task details including title, description, status, priority, labels, estimates, due dates, project, and URL
4. Groups tasks by project for better organization
5. Generates markdown file with filename linear-todos-YYYY-MM-DD.md in the project root
6. Outputs summary showing total tasks and project count

The generated markdown file provides a comprehensive view of your work with all relevant task metadata, making it easy to review priorities and plan your day.

Usage

Trigger this skill with phrases like:

• "What do I need to work on this morning"
• "Show me my work"
• "Load work"
• "Sync my Linear tasks"
• "Get my todo list from Linear"

The skill will execute the sync script and create a dated markdown file in your project root.

Generated File Format

The markdown file follows this structure:

# Linear Tasks - January 18, 2025

Generated: 2025-01-18 09:30:45
Total Tasks: 12

## Project Alpha

### Implement user authentication (High)
- **Status**: In Progress
- **Labels**: backend, security
- **Estimate**: 5 points
- **Due**: 2025-01-20
- **Link**: https://linear.app/team/issue/PROJ-123

Add JWT-based authentication to the API endpoints...

### Fix login bug (Urgent)
- **Status**: Todo
- **Labels**: bug, frontend
- **Estimate**: 2 points
- **Due**: 2025-01-19
- **Link**: https://linear.app/team/issue/PROJ-124

Users cannot log in when using Safari...

## Project Beta

...

Customization

To modify the skill's behavior, edit scripts/sync_linear_tasks.py:

Change GraphQL Query

Modify the QUERY variable to fetch additional fields:

QUERY = """
query {
  viewer {
    assignedIssues(filter: { state: { type: { nin: ["completed", "canceled"] } } }) {
      nodes {
        id
        title
        description
        state { name }
        priority
        labels { nodes { name } }
        estimate
        dueDate
        project { name }
        url
        # Add more fields here
        createdAt
        updatedAt
        assignee { name }
      }
    }
  }
}
"""

Adjust Task Filtering

Modify the filter in the GraphQL query to change which tasks are fetched:

# Include completed tasks from the last week