---
title: Linear
icon: chart-gantt
description: Set up the Linear resource in Python.
---

## Dependencies

No additional dependencies - uses `aiohttp` (included).

For credential setup, see the [Linear Setup](/home/setup/linear) guide.

## Configuration

```python
import os

from mirage import MountMode, Workspace
from mirage.resource.linear import LinearConfig, LinearResource

config = LinearConfig(api_key=os.environ["LINEAR_API_KEY"])
resource = LinearResource(config=config)
ws = Workspace({"/linear/": resource}, mode=MountMode.READ)
```

## Config Reference

| Field       | Required | Description                                 |
| ----------- | -------- | ------------------------------------------- |
| `api_key`   | Yes      | Linear personal API key                     |
| `workspace` | No       | Workspace slug for URL/display usage        |
| `team_ids`  | No       | Restrict the mounted tree to specific teams |
| `base_url`  | No       | GraphQL endpoint, defaults to Linear Cloud  |