open-index/open-npm huggingface dataset:
npm package: @gxtools/linear
Description: gx — structured knowledge base for product teams
Latest version: 0.3.0

# @gx/linear

Shared Linear sync library for gx. Used by `gx-cli` (push/pull commands) and optionally by the server.

## Overview

Bidirectional sync between gx documents (markdown with YAML frontmatter) and Linear issues.

### Field mapping

| gx frontmatter | Linear |
|---|---|
| `title` | issue title |
| `type: feature` | label "feature" |
| `type: epic` | label "epic" |
| `type: decision` | label "decision" |
| `status: draft` | state "Backlog" |
| `status: active` | state "In Progress" |
| `status: accepted` | state "Done" |
| `status: rejected` | state "Canceled" |
| `linear_id: GX-16` | issue identifier |
| `linear_url: https://...` | issue URL |

## Auth

Linear API key via:
1. `GX_LINEAR_API_KEY` env var
2. `linearApiKey` field in `~/.gx/config`

## Offline-first (nvim plugin)

The nvim plugin works fully offline — Linear sync is opt-in via CLI commands only. No sync happens automatically without an explicit `gx linear push` or `gx linear pull`.