Skip to main content
Connect Linear to browse and query issues, projects, and cycles as files.

Connect

airstore connect linear
OAuth in your browser. Grant access to your Linear workspace.

What appears

~/airstore/sources/linear/
├── projects/
│   ├── backend-api/
│   │   ├── ENG-142-auth-refactor.md
│   │   └── ENG-143-rate-limiting.md
│   └── mobile-app/
├── cycles/
│   └── sprint-23/
└── [your smart folders]
Issues are Markdown files with metadata, description, and comments.

Example queries

# Your assigned issues
airstore create sources/linear/my-issues \
  --query "issues assigned to me"

# High priority bugs
airstore create sources/linear/urgent-bugs \
  --query "high priority issues labeled 'bug'"

# Current sprint
airstore create sources/linear/current-sprint \
  --query "issues in the current cycle"

# Issues by project
airstore create sources/linear/api-issues \
  --query "open issues in the Backend API project"

# Recently updated
airstore create sources/linear/recent \
  --query "issues updated in the last 3 days"

File format

# ENG-142: Refactor authentication module

**Status:** In Progress
**Priority:** High
**Assignee:** @johndoe
**Labels:** backend, security
**Project:** Backend API
**Cycle:** Sprint 23

## Description
The current auth module has grown too complex...

## Comments
### @janedoe (2024-01-16)
I've started looking at this. The main issue is...

### @johndoe (2024-01-17)
Good point. Let's also consider...

Supported query filters

FilterExample
Assignee”assigned to me”
Status”in progress issues”, “completed issues”
Priority”high priority”, “urgent”
Labels”labeled ‘bug‘“
Project”in Backend API project”
Cycle”in current cycle”, “in Sprint 23”
Date”created this week”

Limitations

  • Read-only: Linear source is read-only. Use the Linear tool to create or update issues.
  • Workspace scope: Shows issues from workspaces you have access to.

Example workflow

Sprint planning assistant:
# Create smart folders for sprint context
airstore create sources/linear/current-sprint \
  --query "issues in the current cycle"

airstore create sources/linear/backlog \
  --query "unassigned issues with no cycle"

# Use Claude to help plan
cd ~/airstore/sources/linear
claude "Review the current sprint and backlog. Suggest which backlog items to pull in if we have capacity."

Next steps