export

Export issues to JSONL format

Syntax

tracer export [OPTIONS]

Options

--output · path

Output file path (defaults to stdout if not specified)

Short flag: -o

--status · string

Filter by status: open, in_progress, blocked, or closed

Examples

Export to File

# Export all issues to a file
tracer export --output issues.jsonl

Output Format

The export command outputs in JSONL (JSON Lines) format, where each line is a complete JSON object representing one issue:

{"id":"bd-1","title":"Implement authentication","description":"Add OAuth support","status":"closed","priority":1,"issue_type":"feature","assignee":"[e-mail]","estimated_minutes":240,"created_at":"2025-03-01T10:00:00Z","updated_at":"2025-03-03T15:30:00Z","closed_at":"2025-03-03T15:30:00Z","dependencies":[{"issue_id":"bd-1","depends_on_id":"bd-2","type":"blocks","created_at":"2025-03-01T10:05:00Z","created_by":"[e-mail]"}]}
{"id":"bd-2","title":"Design auth schema","description":"","status":"closed","priority":1,"issue_type":"task","assignee":"[e-mail]","created_at":"2025-03-01T09:00:00Z","updated_at":"2025-03-02T16:00:00Z","closed_at":"2025-03-02T16:00:00Z","dependencies":[]}
{"id":"bd-3","title":"Create login endpoint","description":"","status":"open","priority":1,"issue_type":"task","assignee":"","created_at":"2025-03-04T10:00:00Z","updated_at":"2025-03-04T10:00:00Z","dependencies":[{"issue_id":"bd-3","depends_on_id":"bd-1","type":"parent-child","created_at":"2025-03-04T10:01:00Z","created_by":"system"}]}

Issue Structure

Each exported issue includes:

• Core fields: id, title, description, status, priority, issue_type
• Assignment: assignee, estimated_minutes
• Timestamps: created_at, updated_at, closed_at (if closed)
• Dependencies: array of dependency objects with type and metadata
• Optional fields: design, acceptance_criteria, notes, external_ref

Issues are sorted by ID for consistent output. Dependencies are included inline with each issue.

Use export for backups, migration between systems, or version control. The JSONL format is easy to process with tools like jq.