A Rust drop-in for the dex task CLI. It
reads and writes the same .dex/tasks.jsonl store, config files, archive,
GitHub Issues and Shortcut Stories formats, and speaks the same MCP protocol,
with every mutation wrapped in a locked, atomic transaction so concurrent
agents cannot lose each other's writes.
dex is David Cramer's task tracker for coding
agents, published on npm as @zeeg/dex
and documented at dex.rip. dexrust is an independent
reimplementation of its command-line interface in Rust. It tracks
dex v0.16 and reproduces its behaviour closely enough that the two can be
swapped underneath the same store, skills, and instructions:
- Same on-disk formats:
tasks.jsonl,archive.jsonl,dex.toml,.dex/config.toml, andsync-state.json. - Same GitHub issue and Shortcut story bodies, so either tool can sync a remote the other created.
- Same command names, flags, output wording, and JSON shapes.
Where dexrust deliberately differs, it says so in the changelog: writes are
locked and atomic, repeated syncs are idempotent, delete refuses instead of
prompting, and doctor still runs when the config file is broken.
Both projects are MIT licensed. The name dex belongs to the original; this
crate ships a dex binary purely so existing instructions keep working.
The crate is published as dexrust. Every route installs the same two binaries into
~/.cargo/bin:
cargo install dexrust
# or, prebuilt binaries through cargo-binstall:
cargo binstall dexrust
# or
brew install DanielCarmingham/tap/dexrust
# or, prebuilt binaries via the shell installer from the latest GitHub Release:
curl --proto '=https' --tlsv1.2 -LsSf \
https://github.com/DanielCarmingham/dexrust/releases/latest/download/dexrust-installer.sh | sh
# or from a checkout:
cargo install --path .dexrust: canonical binarydex: compatibility binary that runs the same CLI code
Which dex runs depends on PATH order. Installing does not modify, move, or
uninstall an existing npm/pnpm dex; remove that yourself (pnpm remove -g @zeeg/dex) to switch over. dex version always reports dexrust v<version>
so you can tell which one answered.
Every command of dex v0.16 is implemented. The store format, archive format, config files, GitHub issue and Shortcut story formats, and the flags below match the original, so the two tools can share a store and a remote.
Global options: --config <path>, --storage-path <path>, --version.
-
init,-y,--config-dir(writes the default~/.config/dex/dex.toml) -
dir,--global -
config <key>[=<value>],--unset,--list,--global,--local -
status(also the default when no command is given) -
create/add"name"or-n,-d,-p,--parent,--blocked-by -
list/ls[id|search],--all,--completed,--in-progress,--blocked,--ready,--issue <n>,--commit <sha>,--archived,--flat,--json -
show <id>...,--full,--expand,--json -
start <id>,--force -
complete/done<id> --result "...",--commit <sha>,--no-commit,--force -
edit/update<id>,-n,-d,-p,--parent,--add-blocker,--remove-blocker,--commit -
delete/rm/remove<id>,--force -
plan <file>,-p,--parent -
archive <id>or--completedor--older-than 30d, with--exceptand--dry-run; archived tasks go toarchive.jsonlin the original's format and are visible vialist --archivedandshow -
completion <bash|zsh|fish|...>, named after the invoked binary -
sync [id],--github,--shortcut,--dry-run; pushes root tasks to GitHub Issues and Shortcut Stories per[sync.github]/[sync.shortcut] -
import <#N|owner/repo#N|url|sc#N>,--all,--github,--shortcut,--update,--dry-run -
export <id>...,--dry-run(GitHub, no metadata saved back) -
mcp(stdio Model Context Protocol server withcreate_task,update_task, andlist_tasks) -
doctor,--fix -
help,version
Mutations run the original auto-sync hook when a sync service is enabled
(sync.<service>.auto.on_change, default true, or auto.max_age), and
archive.auto archives old completed tasks on write.
DEX_GITHUB_API_URL and DEX_SHORTCUT_API_URL point the API clients at any
base URL; the test suite uses them to run against a local mock server.
Same precedence as original dex: --storage-path, then storage.file.path
from config, then DEX_STORAGE_PATH, then either the centralized project
directory under the dex home (storage.file.mode = "centralized") or
<git-root>/.dex, falling back to <dex home>/local outside a repository.
The dex home is DEX_HOME, else $XDG_CONFIG_HOME/dex, else ~/.config/dex.
Set DEX_REFERENCE_BIN to the original dex executable to make the test suite
also verify that a store written by dexrust is accepted by it:
DEX_REFERENCE_BIN="$(command -v dex)" cargo test