VoidTrack Docs

Importing from Linear

Bring over an existing Linear workspace, preserving keys and identifiers.

apps/web/src/db/import-linear.ts recreates a Linear workspace in VoidTrack: users, teams, initiatives, projects, and open issues. It preserves team keys and issue numbers, and links each imported issue back to its original in Linear.

Input format

The script reads a data directory containing:

  • structure.json: workspace, teams, projects, and initiatives.
  • issues-*.jsonl: one JSON object per line, per issue.

Run it with:

tsx apps/web/src/db/import-linear.ts <data-dir> [workspace-slug]

See the script header in apps/web/src/db/import-linear.ts for the exact shape each file expects.

On this page