dex-git-diff

Custom Git diff driver for Dex .dex/tasks.jsonl.

Shows task-level changes only:

• status ([ ], [>], [x])
• task id
• task name
• optional parent id marker

Hides JSONL churn (updated_at, metadata, long result blobs, etc.).

Quick Start

Install + wire globally (recommended):

npm install -g dex-git-diff
dex-git-diff install --global
git diff -- .dex/tasks.jsonl

One-off without global npm install:

npx -y dex-git-diff install --global

Install Options

Install from npm:

npm install -g dex-git-diff

Install from local checkout:

npm install -g /absolute/path/to/dex-git-diff

Commands

dex-git-diff install [--global | --repo] [--tracked]
dex-git-diff uninstall [--global | --repo] [--tracked]
dex-git-diff doctor
dex-git-diff textconv <path-to-tasks.jsonl>

Setup Modes

install --global:

Configures:

• diff.dex-tasks.textconv
• diff.dex-tasks.cachetextconv=true
• global Git attributes file entry:
  • .dex/tasks.jsonl diff=dex-tasks

Effect: any repo with .dex/tasks.jsonl gets custom diff locally on your machine.

install --repo:

Configures current repo only.

By default writes attributes to .git/info/attributes (local-only, untracked).

Use --tracked to write to .gitattributes (share with team).

Examples:

# Local-only in current repo
dex-git-diff install --repo

# Shared in current repo (.gitattributes)
dex-git-diff install --repo --tracked

Verify

dex-git-diff doctor
git check-attr diff -- .dex/tasks.jsonl
git diff -- .dex/tasks.jsonl

doctor should show attr binding with diff: dex-tasks for .dex/tasks.jsonl.

Uninstall

# Remove global wiring
dex-git-diff uninstall --global

# Remove repo wiring in current repo
dex-git-diff uninstall --repo

# Also remove tracked .gitattributes entry
dex-git-diff uninstall --repo --tracked

Notes

• Safe for remotes: this is local Git behavior.
• If another machine lacks the driver config, it falls back to normal JSON diff.
• If your g diff alias/wrapper ignores textconv, use git diff -- .dex/tasks.jsonl directly.

Package Metadata Placeholders

Fill these in package.json before publish:

• author
• repository.url
• homepage
• bugs.url

Dev

npm test
npm run pack:check