> ## Documentation Index
> Fetch the complete documentation index at: https://abil-shrestha-tracer.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# export

> Export issues to JSONL format

## Syntax

```bash theme={null}
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

```bash Export to File theme={null}
# Export all issues to a file
tracer export --output issues.jsonl
```

```bash Export to Stdout theme={null}
# Export to stdout for piping
tracer export > backup.jsonl
```

```bash Filter by Status theme={null}
# Export only open issues
tracer export --status open --output open-issues.jsonl
```

```bash Export Closed Issues theme={null}
# Export completed work for archival
tracer export --status closed --output archive.jsonl
```

## Output Format

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

```jsonl theme={null}
{"id":"bd-1","title":"Implement authentication","description":"Add OAuth support","status":"closed","priority":1,"issue_type":"feature","assignee":"alice@example.com","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":"alice@example.com"}]}
{"id":"bd-2","title":"Design auth schema","description":"","status":"closed","priority":1,"issue_type":"task","assignee":"alice@example.com","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

> [!NOTE]
>
> Issues are sorted by ID for consistent output. Dependencies are included inline with each issue.

> [!TIP]
>
> Use export for backups, migration between systems, or version control. The JSONL format is easy to process with tools like `jq`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.