dex

Task tracking for AI agents. Persistent memory for complex, multi-session work.

Why dex?

Structured tasks, not simple todos. Each task captures full context:

- Description: One-line summary (like an issue title)
- Context: Background, requirements, approach (like an issue body)
- Result: Implementation summary, decisions, outcomes (like a PR description)

Built for agent coordination. Agents break down work, track progress, and record results that persist across sessions.

Git-friendly storage. JSONL format (one task per line) enables collaboration, versioning, and conflict-free merges.

Quick Start

Install dex globally:

``bash
npm install -g @zeeg/dex
`

Or use the skills installer for your AI agent (Claude Code, OpenCode, Codex, Cursor):

`bash
npx skills add dcramer/dex
`

Use natural language or slash commands:

`
> Use Dex. Work on the next logical task. When done, run code-simplifier and commit.
`

`
/dex create a task to refactor the authentication module
`

Read the full documentation →

Contributing

$3

`bash
git clone git@github.com:dcramer/dex.git
cd dex
pnpm install && pnpm build
pnpm link # Makes 'dex' command available globally
`

$3

`bash
pnpm dev # Watch mode - auto-rebuild on changes
`

$3

Test the plugin locally without installing from the marketplace:

`bash
claude --plugin-dir plugins/dex
`

This loads the plugin from the local directory. Restart your AI agent to pick up changes.

$3

`bash


Make changes...


pnpm build
pnpm test
`

$3

Releases are automated via GitHub Actions when a version tag is pushed.

`bash


Run tests, build, and bump version (creates git tag)

pnpm release patch # 0.1.0 → 0.1.1
pnpm release minor # 0.1.0 → 0.2.0
pnpm release major # 0.1.0 → 1.0.0

Push commit and tag to trigger publish

git push --follow-tags
``

The workflow runs tests and publishes to npm with provenance.