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