# Linear Import

> Import issues from CSV or JSON files. Use when bulk-creating issues from external data.

- Skill: `finesssee/linear-import` (Agent Skill)
- Install (CLI): `npx skillmds@latest add finesssee/linear-import`
- Raw SKILL.md: https://api.skillmd.com/api/skills/finesssee/linear-import/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: Finesssee (https://skillmd.com/u/finesssee)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/finesssee/linear-import

---


# Import

```bash
# Import from CSV
linear-cli im csv issues.csv -t ENG

# Preview without creating (dry run)
linear-cli im csv issues.csv -t ENG --dry-run

# Import from JSON
linear-cli im json issues.json -t ENG

# JSON round-trip (export then re-import)
linear-cli exp json -t ENG -f backup.json
linear-cli im json backup.json -t ENG
```

## CSV Format

CSV files need a header row. Supported columns: `title`, `description`, `priority`, `status`, `assignee`, `labels`, `estimate`, `dueDate`.

Status, assignee, and labels are resolved by name automatically.

## JSON Format

JSON files should be an array of issue objects matching the export format.

## Flags

| Flag | Purpose |
|------|---------|
| `-t TEAM` | Target team (required) |
| `--dry-run` | Preview without creating |
| `--output json` | JSON output |

## Exit Codes

`0`=Success, `1`=Error, `2`=Not found, `3`=Auth error