@gxtools/linear
v0.3.0
Published
gx — structured knowledge base for product teams
Readme
@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:
GX_LINEAR_API_KEYenv varlinearApiKeyfield 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.
