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:

npm install -g @zeeg/dex

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

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

Development Setup

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

Development Cycle

pnpm dev       # Watch mode - auto-rebuild on changes

Testing Locally

Test the plugin locally without installing from the marketplace:

claude --plugin-dir plugins/dex

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

Manual Build

# Make changes...
pnpm build
pnpm test

Releasing

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

# 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.