Skip to content
swelog

Linear

Linear fetching records the issues assigned to a configured workspace user. By default, it gets the issues assigned to you today, plus the ones you just moved to canceled or completed.

Setup

Section titled “Setup”

  1. Set the exact Linear assignee name in swelog.json:

    {
      "linearUsername": "rudrapatel"
    }

  2. Run the fetch command:

    Terminal window
    swelog fetch linear

  3. On first use, swelog prints a Linear authorization URL and attempts to open it in your browser. If the browser does not open, use the printed URL.

  4. Complete authorization. Swelog stores the resulting OAuth credentials in your operating system keyring and reuses or refreshes them on later runs.

  5. To backfill a previous date, provide MM-DD-YYYY:

    Terminal window
    swelog fetch linear --date 08-17-2026

    This records the issues Linear shows activity on for that date, including the ones you completed or canceled, because finishing an issue is exactly what a past day’s log should capture.

    --yesterday does the same for the day before:

    Terminal window
    swelog fetch linear --yesterday

Output

Section titled “Output”

The generated section groups issues by status:

## Linear


### In Progress


- [ENG-123](https://linear.app/...) Implement OAuth callback handling


### Todo


- [ENG-456](https://linear.app/...) Document the Linear integration

What --date can and cannot recover

Section titled “What --date can and cannot recover”

The Linear MCP server does not expose issue history, so swelog can only match on the timestamps Linear stores on the issue itself: updatedAt, completedAt, canceledAt, startedAt, and createdAt. An issue is recorded for a date when any of those lands on it, read in your local time zone.

completedAt, canceledAt, startedAt, and createdAt never change, so issues you started, finished, canceled, or filed on a date come back no matter how long you wait to backfill.

updatedAt only holds the most recent change. An issue you touched on Monday and again on Tuesday counts as Tuesday only. So backfill soon after the fact for the best result, and treat what --date returns as a reminder for your own notes rather than a full record.

Archived issues are the one thing --date cannot reach. Swelog asks Linear to leave them out, so an issue you finished on a date and archived afterwards will not come back.

Switching accounts or organizations

Section titled “Switching accounts or organizations”

Update linearUsername when needed, clear the stored authorization, and fetch again:

Terminal window
swelog auth clear linear
swelog fetch linear

The next fetch starts a new browser authorization flow.